Configuración de los complementos del Editor de texto enriquecido

Las funcionalidades de RTE están disponibles a través de una serie de complementos, cada uno con propiedad de características. Puede configurar la propiedad de funciones para habilitar o deshabilitar, una o más características de RTE. Este artículo describe cómo configurar específicamente los complementos RTE.

Para obtener más información sobre las otras configuraciones de RTE, consulte configurar editor de texto enriquecido.

NOTA

Al trabajar con CRXDE Lite, se recomienda guardar los cambios con regularidad mediante Guardar todo .

Activar un complemento y configurar la propiedad de funciones

Para activar un complemento, siga estos pasos. Algunos pasos solo son necesarios cuando configura un complemento por primera vez, ya que los nodos correspondientes no existen.

De forma predeterminada, format, link, list, justifyy control y todas sus funciones están habilitadas en RTE.

NOTA

Las rtePlugins el nodo se denomina <rtePlugins-node> para evitar duplicaciones en este artículo.

  1. Con el CRXDE Lite , busque el componente de texto del proyecto.

  2. Cree el nodo principal de <rtePlugins-node> si no existe, antes de configurar cualquier complemento RTE:

    • Según el componente, los nodos principales son:

      • config: .../text/cq:editConfig/cq:inplaceEditing/config
      • un nodo de configuración alternativo: .../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
      • text: .../text/dialog/items/tab1/items/text
    • Son del tipo: jcr:primaryType cq:Widget

    • Ambas tienen la siguiente propiedad:

      • Nombre name
      • Tipo String
      • Valor ./text
  3. En función de la interfaz para la que esté configurando, cree un nodo <rtePlugins-node>, si no existe:

    • Nombre rtePlugins
    • Tipo nt:unstructured
  4. A continuación, cree un nodo para cada complemento que desee activar:

    • Tipo nt:unstructured
    • Nombre el ID del complemento requerido

Después de activar un complemento, siga estas directrices para configurar la variable features propiedad.

Habilitar todas las funciones Habilite algunas funciones específicas. Deshabilite todas las funciones.
Nombre características características características
Tipo Cadena String (cadena múltiple; establecer tipo en String y haga clic en Multi en CRXDE Lite) Cadena
Value * (un asterisco) Establezca uno o varios valores de característica. -

Comprender el complemento Findreplace

La variable findreplace no necesita ninguna configuración. Funciona de forma predeterminada.

Al utilizar la funcionalidad de reemplazo, la cadena de reemplazo que se va a reemplazar debe introducirse al mismo tiempo que la cadena de búsqueda. Sin embargo, puede hacer clic en Buscar para buscar la cadena antes de reemplazarla. Si se introduce la cadena de reemplazo después de hacer clic en Buscar, la búsqueda se restablecerá al principio del texto.

El cuadro de diálogo buscar y reemplazar se volverá transparente cuando se haga clic en buscar y se volverá opaco cuando se haga clic en reemplazar. El comportamiento permite al autor revisar el texto que se va a reemplazar. Si los usuarios hacen clic en reemplazar todo, el cuadro de diálogo se cerrará y mostrará el número de reemplazos realizados.

Configuración de los modos de pegado

Al utilizar RTE, los autores pueden pegar contenido en uno de los tres modos siguientes:

  • Modo de explorador: Pegue texto con la implementación de pegado predeterminada del explorador. No es un método recomendado, ya que puede introducir marcas no deseadas.

  • Modo de texto sin formato: Pegue el contenido del portapapeles como texto sin formato. Elimina todos los elementos de estilo y formato del contenido copiado antes de insertarlos en Experience Manager componente.

  • Modo MS Word: Pegue el texto, incluidas las tablas, con formato al copiar desde MS Word. No se admite la copia y el pegado de texto desde otro origen, como una página web o MS Excel, y solo se conserva el formato parcial.

Configurar las opciones de pegado disponibles en la barra de herramientas de RTE

Puede proporcionar algunos, todos o ninguno de estos tres iconos a sus autores en la barra de herramientas de RTE:

  • Pegar (Ctrl+V): Se puede preconfigurar para que se corresponda con uno de los tres modos de pegado anteriores.

  • Pegar como texto: Proporciona funcionalidad de modo de texto sin formato.

  • Pegar desde Word: Proporciona funcionalidad de modo MS Word.

Para configurar RTE para que muestre los iconos necesarios, siga estos pasos.

  1. Vaya al componente, por ejemplo /apps/<myProject>/components/text.
  2. Vaya al nodo rtePlugins/edit. Consulte activar un complemento si el nodo no existe.
  3. Cree la variable features en la variable edit y agregue una o más de las funciones. Guarde todos los cambios.

Configuración del comportamiento del icono y el acceso directo Pegar (Ctrl+V)

Puede preconfigurar el comportamiento de la variable Pegar (Ctrl+V) mediante los pasos siguientes. Esta configuración también define el comportamiento del método abreviado de teclado Ctrl+V que utilizan los autores para pegar contenido.

La configuración permite los tres tipos de casos de uso siguientes:

  • Pegue texto con la implementación de pegado predeterminada del explorador. No es un método recomendado, ya que puede introducir marcas no deseadas. Configurado con browser más abajo.

  • Pegue el contenido del portapapeles como texto sin formato. Elimina todos los elementos de estilo y formato del contenido copiado antes de insertarlos en Experience Manager componente. Configurado con plaintext más abajo.

  • Pegue el texto, incluidas las tablas, con formato al copiar desde MS Word. No se admite la copia y el pegado de texto desde otro origen, como una página web o MS Excel, y solo se conserva el formato parcial. Configurado con wordhtml más abajo.

  1. En el componente, vaya a <rtePlugins-node>/edit nodo . Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. En el edit cree una propiedad mediante los siguientes detalles:

    • Nombre defaultPasteMode
    • Tipo String
    • Valor es uno de los modos de pegado requeridos de browser, plaintexto wordhtml los modos.

Configurar los formatos permitidos al pegar contenido

Pegar como Microsoft-Word (paste-wordhtml) se puede configurar aún más para que pueda permitir explícitamente algunos estilos al pegar en Experience Manager de otro programa, como Microsoft Word.

Por ejemplo, si solo se deben permitir formatos y listas en negrita al pegar en Experience Manager, puede filtrar los demás formatos. Esto se denomina filtrado de pegado configurable, que se puede hacer para ambos:

Para los vínculos, también puede definir los protocolos que se aceptan automáticamente.

Configurar los formatos permitidos al pegar texto en Experience Manager de otro programa:

  1. En el componente, vaya al nodo . <rtePlugins-node>/edit. Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. Cree un nodo en el edit para guardar las reglas de pegado del HTML:

    • Nombre htmlPasteRules
    • Tipo nt:unstructured
  3. Cree un nodo en htmlPasteRules, para incluir detalles de los formatos básicos permitidos:

    • Nombre allowBasics
    • Tipo nt:unstructured
  4. Para controlar los formatos individuales aceptados, cree una o varias de las siguientes propiedades en la variable allowBasics nodo:

    • Nombre bold
    • Nombre italic
    • Nombre underline
    • Nombre anchor (para vínculos y anclajes con nombre)
    • Nombre image

    Todas las propiedades son de Tipo Boolean, de modo que en el Valor puede seleccionar o quitar la marca de verificación para habilitar o deshabilitar la funcionalidad.

    NOTA

    Si no se define explícitamente, se utiliza el valor predeterminado de true y se acepta el formato .

  5. También se pueden definir otros formatos utilizando una serie de otras propiedades o nodos, aplicados también a la variable htmlPasteRules nodo:

Propiedad Tipo Descripción
allowBlockTags String Define la lista de etiquetas de bloque permitidas. Algunas etiquetas de bloque posibles incluyen titulares (h1, h2, h3), párrafos §, listas (ol, ul), tablas (tabla).
fallbackBlockTag String Define la etiqueta de bloque utilizada para cualquier bloque que tenga una etiqueta de bloque no incluida en allowBlockTags. Normalmente, p suficientes.
table nt:unstructured Define el comportamiento al pegar tablas. Este nodo debe tener la propiedad allow (type Boolean) para definir si se permite pegar tablas. Si allow se establece en false, debe especificar la propiedad ignoreMode (type String) para definir cómo se gestiona el contenido de la tabla pegada. Los valores válidos para ignoreMode son remove para eliminar el contenido de la tabla y paragraph para transformar celdas de tabla en párrafos.
list nt:unstructured Define el comportamiento al pegar listas. Debe tener la propiedad allow (escriba Boolean) para definir si se permite pegar listas. If allow está configurado como false, especifique la propiedad ignoreMode (tipo String) para definir cómo gestionar cualquier contenido de lista pegado. Los valores válidos para ignoreMode son remove que elimina el contenido de la lista y paragraph que convierte los elementos de la lista en párrafos.

Un ejemplo de una htmlPasteRules estructura a continuación:

"htmlPasteRules": {
    "allowBasics": {
        "italic": true,
        "link": true
    },
    "allowBlockTags": [
        "p", "h1", "h2", "h3"
    ],
    "list": {
        "allow": false,
        "ignoreMode": "paragraph"
    },
    "table": {
        "allow": true,
        "ignoreMode": "paragraph"
    }
}
  1. Guarde todos los cambios.

Configuración de estilos de texto

Los autores pueden aplicar Estilos para cambiar el aspecto de una parte del texto. Los estilos se basan en clases CSS predefinidas en la hoja de estilos CSS. El contenido estilizado se incluye en span etiquetas que utilizan la variable class para hacer referencia a la clase CSS. Por ejemplo:

<span class=monospaced>Monospaced Text Here</span>

Cuando el complemento Estilos está habilitado por primera vez, no hay estilos predeterminados disponibles. La lista emergente está vacía. Para proporcionar a los autores estilos, haga lo siguiente:

  • Habilite el selector desplegable Estilo .
  • Especifique una o varias ubicaciones de las hojas de estilo.
  • Especifique los estilos individuales que se pueden seleccionar en la lista emergente de estilo.

Para reconfiguraciones posteriores, por ejemplo, para agregar más estilos, siga solamente las instrucciones para hacer referencia a una nueva hoja de estilo y especificar los estilos adicionales.

NOTA

Los estilos también se pueden definir para tablas o celdas de tabla. Estas configuraciones requieren procedimientos separados.

Habilitar la lista de selector desplegable Estilo

Esto se hace habilitando el complemento de estilos.

  1. En el componente, vaya al nodo . <rtePlugins-node>/styles. Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. Cree la variable features en la variable styles nodo:

    • Nombre features
    • Tipo String
    • Valor * (asterisco)
  3. Guarde todos los cambios.

NOTA

Una vez habilitado el complemento Estilos, la lista desplegable Estilo se muestra en el cuadro de diálogo de edición. Sin embargo, la lista está vacía ya que no se ha configurado ningún estilo.

Especificar la ubicación de la hoja de estilo

A continuación, especifique la ubicación de las hojas de estilo a las que desea hacer referencia:

  1. Vaya al nodo raíz del componente de texto, por ejemplo /apps/<myProject>/components/text.

  2. Añadir la propiedad externalStyleSheets al nodo principal de <rtePlugins-node>:

    • Nombre externalStyleSheets
    • Tipo String[] (cadena múltiple; click Multi en CRXDE)
    • Valores Ruta y nombre de archivo de cada hoja de estilo que desee incluir. Utilice rutas de repositorio.
    NOTA

    Puede agregar referencias a hojas de estilo adicionales más adelante.

  3. Guarde todos los cambios.

Al utilizar RTE en un cuadro de diálogo (IU clásica), puede especificar las hojas de estilo que están optimizadas para la edición de texto enriquecido. Debido a restricciones técnicas, el contexto CSS se pierde en el editor, por lo que puede emular este contexto para mejorar la experiencia WYSIWYG.

El Editor de texto enriquecido utiliza un elemento DOM de contenedor con un ID de CQrte que proporciona diferentes estilos para ver y editar:

#CQ td {
// defines the style for viewing
 }
#CQrte td {
 // defines the style for editing
 }

Especifique los estilos disponibles en la lista emergente

  1. En la definición del componente, vaya al nodo <rtePlugins-node>/styles, tal como se crea en Activación del selector desplegable de estilo.

  2. Bajo el nodo styles, cree un nodo (también llamado styles) para que la lista esté disponible:

    • Nombre styles
    • Tipo cq:WidgetCollection
  3. Cree un nodo en el styles para representar un estilo individual:

    • Nombre, puede especificar el nombre, pero debería ser adecuado para el estilo
    • Tipo nt:unstructured
  4. Añadir la propiedad cssName a este nodo para hacer referencia a la clase CSS:

    • Nombre cssName
    • Tipo String
    • Valor El nombre de la clase CSS (sin un '.' anterior); por ejemplo, cssClass en lugar de .cssClass)
  5. Añadir la propiedad text al mismo nodo; esto define el texto mostrado en el cuadro de selección:

    • Nombre text
    • Tipo String
    • Valor Descripción del estilo; aparece en el cuadro de selección desplegable Estilo .
  6. Guarde los cambios.

    Repita los pasos anteriores para cada estilo necesario.

Configurar RTE para saltos de palabras óptimos en japonés

Autores que utilizan Experience Manager para crear contenido en japonés, puede aplicar un estilo a los caracteres para evitar un salto de línea cuando no sea necesario un salto. Esto permite a los autores dejar que las frases rompan en la posición deseada. El estilo de esta funcionalidad se basa en la clase CSS predefinida en la hoja de estilos CSS.

Para crear el estilo que los autores pueden aplicar al texto en japonés, siga estos pasos:

  1. Cree un nodo bajo el nodo estilos . Consulte especificar un estilo.

    • Nombre: jpn-word-wrap
    • Tipo: nt:unstructure
  2. Añadir la propiedad cssName al nodo para hacer referencia a la clase CSS. Este nombre de clase es un nombre reservado para la función de ajuste de palabras en japonés.

    • Nombre: cssName
    • Tipo: String
    • Valor: jpn-word-wrap (sin precedente .)
  3. Agregue el texto de la propiedad al mismo nodo. El valor es el nombre del estilo que los autores ven al seleccionar el estilo.

    • Nombre: text
      *Tipo:
      String
    • Value: Japanese word-wrap
  4. Cree una hoja de estilo y especifique su ruta. Consulte especificar la ubicación de la hoja de estilo. Agregue el siguiente contenido a la hoja de estilo. Cambie el color de fondo como desee.

    .text span.jpn-word-wrap {
        display:inline-block;
    }
    .is-edited span.jpn-word-wrap {
        background-color: #ffddff;
    }
    

    Hoja de estilo para que la función de ajuste de palabras en japonés esté disponible para los autores

Configuración de los formatos de párrafo

Cualquier texto creado en RTE se coloca dentro de una etiqueta de bloque; el valor predeterminado es <p>. Al habilitar la variable paraformat , puede especificar etiquetas de bloque adicionales que se pueden asignar a los párrafos mediante una lista desplegable de selección. Los formatos de párrafo determinan el tipo de párrafo asignando la etiqueta de bloque correcta. El autor puede seleccionarlos y asignarlos mediante el selector de formato. Las etiquetas de bloque de ejemplo incluyen, entre otras, el párrafo estándar <p> y encabezados <h1>, <h2>, etc.

PRECAUCIÓN

Este complemento no es adecuado para contenido con estructura compleja, como listas o tablas.

NOTA

Si una etiqueta de bloque es, por ejemplo, una <hr> , no se puede asignar a un párrafo, no es un caso de uso válido para un paraformat complemento.

Cuando el complemento Formatos de párrafo está habilitado por primera vez, no hay disponibles formatos de párrafo predeterminados. La lista emergente está vacía. Para proporcionar a los autores formatos de párrafo, haga lo siguiente:

  • Active la variable Formato lista de selectores emergentes.
  • Especifique las etiquetas de bloque que se pueden seleccionar como formatos de párrafo en el menú emergente.

Para reconfiguraciones posteriores, por ejemplo, para añadir más formatos, siga solo la parte relevante de las instrucciones.

Activación del selector desplegable Formato

Para habilitar la variable paraformat siga estos pasos:

  1. En el componente, vaya al nodo . <rtePlugins-node>/paraformat. Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. Cree la variable features en la variable paraformat nodo:

    • Nombre features
    • Tipo String
    • Valor * (asterisco)
NOTA

Si el complemento no está configurado más, los formatos predeterminados que están habilitados son Párrafo ( <p>), Encabezado 1 ( <h1>), Encabezado 2 ( <h2>), Encabezado 3 ( <h3>).

PRECAUCIÓN

Al configurar los formatos de párrafo de RTE, no elimine la etiqueta de párrafo <p> como opción de formato. Si la variable <p> se elimina, el autor del contenido no puede seleccionar la etiqueta Formatos de párrafo incluso si hay otros formatos configurados.

Especificar los formatos de párrafo disponibles

Los formatos de párrafo están disponibles para su selección mediante:

  1. En la definición del componente, vaya al nodo <rtePlugins-node>/paraformat, tal como se crea en Activación del selector desplegable de formato.

  2. En el paraformat crear un nodo, para guardar la lista de formatos:

    • Nombre formats
    • Tipo cq:WidgetCollection
  3. Cree un nodo en el formats , contiene detalles de un formato individual:

    • Nombre, puede especificar el nombre, pero debería ser adecuado para el formato (por ejemplo, myParagraph, myheader1).
    • Tipo nt:unstructured
  4. A este nodo, añada la propiedad para definir la etiqueta de bloque utilizada:

    • Nombre tag

    • Tipo String

    • Valor La etiqueta de bloque del formato; por ejemplo: p, h1, h2, etc.

      No es necesario introducir los corchetes angulares delimitadores.

  5. Al mismo nodo agregue otra propiedad para que el texto descriptivo aparezca en la lista desplegable:

    • Nombre description
    • Tipo String
    • Valor Texto descriptivo para este formato; por ejemplo, Párrafo, Encabezado 1, Encabezado 2, etc. Este texto se muestra en la lista de selección Formato.
  6. Guarde los cambios.

    Repita los pasos para cada formato necesario.

PRECAUCIÓN

Si define formatos personalizados, los formatos predeterminados (<p>, <h1>, <h2>y <h3>). Volver a crear <p> ya que es el formato predeterminado.

Configuración de caracteres especiales

En un Experience Manager instalación, cuando el misctools está habilitado para caracteres especiales (specialchars) una selección predeterminada está disponible inmediatamente para su uso; por ejemplo, los símbolos copyright y marca comercial.

Puede configurar el RTE para que su selección de caracteres esté disponible; definiendo caracteres distintos o una secuencia completa.

PRECAUCIÓN

Al añadir los caracteres especiales, se anula la selección predeterminada. Si es necesario, redefina estos caracteres en la selección.

Definir un solo carácter

  1. En el componente, vaya al nodo . <rtePlugins-node>/misctools. Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. Cree la variable features en la variable misctools nodo:

    • Nombre features

    • Tipo String[]

    • Valor specialchars

      (o String / * si se aplican todas las funciones de este complemento)

  3. En misctools cree un nodo para mantener las configuraciones de caracteres especiales:

    • Nombre specialCharsConfig
    • Tipo nt:unstructured
  4. En specialCharsConfig cree otro nodo para guardar la lista de caracteres:

    • Nombre chars
    • Tipo nt:unstructured
  5. En chars agregue un nodo para mantener una definición de carácter individual:

    • Nombre puede especificar el nombre, pero debe reflejar el carácter; por ejemplo, la mitad.
    • Tipo nt:unstructured
  6. A este nodo agregue la siguiente propiedad:

    • Nombre entity
    • Tipo String
    • Valor la representación del HTML del carácter requerido; por ejemplo, &189; para la fracción una mitad.
  7. Guarde los cambios.

En CRXDE, una vez guardada la propiedad, se muestra el carácter representado. Consulte a continuación el ejemplo de la mitad. Repita los pasos anteriores para que los autores tengan más caracteres especiales disponibles.

En CRXDE, añada un solo carácter para que esté disponible en la barra de herramientas de RTE

Definir un rango de caracteres

  1. Utilice los pasos del 1 al 3 desde Definir un solo carácter.

  2. En chars agregue un nodo para mantener la definición del rango de caracteres:

    • Nombre puede especificar el nombre, pero debe reflejar el intervalo de caracteres; por ejemplo, lápices.
    • Tipo nt:unstructured
  3. Bajo este nodo (cuyo nombre depende del rango de caracteres especial), agregue las dos propiedades siguientes:

    • Nombre rangeStart

      Tipo Long
      Valor el Unicode representación (decimal) del primer carácter del rango

    • Nombre rangeEnd

      Tipo Long
      Valor el Unicode representación (decimal) del último carácter del rango

  4. Guarde los cambios.

    Por ejemplo, si define un intervalo de 9998 a 1000, obtendrá los siguientes caracteres.

    En CRXDE, defina un rango de caracteres para que estén disponibles en RTE

    Figura: En CRXDE, defina un rango de caracteres para que estén disponibles en RTE

    Los caracteres especiales disponibles en RTE se muestran a los autores en una ventana emergente

Configuración de estilos de tabla

Los estilos se suelen aplicar al texto, pero también se puede aplicar un conjunto independiente de estilos en una tabla o en unas pocas celdas de la tabla. Estos estilos están disponibles para los autores del cuadro de selector Estilo de las propiedades Celda o Propiedades de tabla. Los estilos están disponibles al editar una tabla dentro de un componente de texto (o derivado) y no en el componente de tabla estándar.

NOTA

Puede definir estilos para tablas y celdas solo para la IU clásica.

NOTA

Copiar y pegar tablas en o desde el componente RTE depende del explorador. No es compatible de serie para todos los exploradores. Puede obtener resultados variados según la estructura de la tabla y el navegador. Por ejemplo, cuando copia y pega una tabla en un componente RTE en Mozilla Firefox en la IU clásica y la IU táctil, no se conserva el diseño de la tabla.

  1. Dentro del componente, vaya al nodo <rtePlugins-node>/table. Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. Cree la variable features en la variable table nodo:

    • Nombre features
    • Tipo String
    • Valor *
    NOTA

    Si no desea habilitar todas las funciones de la tabla, puede crear la variable features como:

    • Tipo String[]
    • Valor s) una, o ambas, de las siguientes, según sea necesario:
    * `table` permitir la edición de las propiedades de la tabla; incluidos los estilos. * `cellprops` para permitir la edición de propiedades de celda, incluidos los estilos.
  3. Defina la ubicación de las hojas de estilo CSS para consultarlas. Consulte Especificación de la ubicación de la hoja de estilo ya que esto es lo mismo que al definir estilos para texto. La ubicación se puede definir si ha definido otros estilos.

  4. En el table cree los siguientes nodos según sea necesario:

    • Definición de estilos para toda la tabla (disponible en Propiedades de tabla):

      • Nombre tableStyles
      • Tipo cq:WidgetCollection
    • Definición de estilos para celdas individuales (disponibles en Propiedades de celda),

      • Nombre cellStyles
      • Tipo cq:WidgetCollection
  5. Cree un nodo (en la sección tableStyles o cellStyles nodo según corresponda) para representar un estilo individual,

    • Nombre puede especificar el nombre, pero debe reflejar el estilo.
    • Tipo nt:unstructured
  6. En este nodo, cree las propiedades:

    • Para definir el estilo CSS al que se hace referencia,

      • Nombre cssName
      • Tipo String
      • Valor el nombre de la clase CSS (sin un ., por ejemplo, cssClass en lugar de .cssClass)
    • Para definir un texto descriptivo que aparece en el selector emergente,

      • Nombre text
      • Tipo String
      • Valor el texto que aparecerá en la lista de selección
  7. Guarde todos los cambios.

Repita los pasos anteriores para cada estilo necesario.

Configuración de encabezados ocultos en tablas para accesibilidad

A veces, puede crear tablas de datos sin texto visual en el encabezado de una columna suponiendo que el propósito del encabezado esté implícito en la relación visual de la columna con otras columnas. En este caso, es necesario proporcionar texto interno oculto dentro de la celda en la celda del encabezado para permitir que los lectores de pantalla y otras tecnologías de asistencia ayuden a los lectores con distintas necesidades a comprender el propósito de la columna.

Para mejorar la accesibilidad en estos escenarios, RTE admite celdas de encabezado ocultas. Además, proporciona ajustes de configuración relacionados con encabezados ocultos en tablas. Esta configuración le permite aplicar estilos CSS en encabezados ocultos en los modos de edición y previsualización. Para ayudar a los autores a identificar encabezados ocultos en el modo de edición, incluya los siguientes parámetros en el código:

  • hiddenHeaderEditingCSS: Especifica el nombre de la clase CSS que se aplica en la celda de encabezado oculto, cuando se edita RTE.
  • hiddenHeaderEditingStyle: Especifica una cadena de estilo que se aplica en la celda de encabezado oculto cuando se edita RTE.

Si especifica la CSS y la cadena Estilo en el código, la clase CSS tiene prioridad sobre la cadena de estilo y puede sobrescribir cualquier cambio de configuración que realice la cadena Estilo.

Para ayudar a los autores a aplicar CSS en encabezados ocultos en el modo de vista previa, puede incluir los siguientes parámetros en el código:

  • hiddenHeaderClassName: Especifica el nombre de la clase CSS que se aplica en la celda de encabezado oculto en el modo de vista previa.
  • hiddenHeaderStyle: Especifica una cadena Style que se aplica a la celda de encabezado oculto en el modo de vista previa.

Si especifica la CSS y la cadena Estilo en el código, la clase CSS tiene prioridad sobre la cadena de estilo y puede sobrescribir cualquier cambio de configuración que realice la cadena Estilo.

Agregar diccionarios para el corrector ortográfico

Cuando se activa el complemento de revisión ortográfica, el RTE utiliza diccionarios para cada idioma adecuado. A continuación, se seleccionan según el idioma del sitio web tomando la propiedad de idioma del subárbol o extrayendo el idioma de la dirección URL; por ejemplo. el /en/ la rama está marcada como Inglés, la variable /de/ como alemán.

NOTA

El mensaje "Corrección ortográfica fallida". se ve si se intenta realizar una comprobación para un idioma que no está instalado.

Una instalación de Experience Manager estándar incluye los diccionarios para:

  • Inglés americano (en_us)
  • Inglés británico (en_gb)
NOTA

Los diccionarios estándar se encuentran en /libs/cq/spellchecker/dictionaries, junto con los archivos Léame correspondientes. No modifique los archivos.

Para agregar más diccionarios, si es necesario, siga estos pasos.

  1. Vaya a la página https://extensions.openoffice.org/.

  2. Seleccione el idioma requerido y descargue el archivo ZIP con las definiciones de ortografía. Extraiga el contenido del archivo en su sistema de archivos.

    PRECAUCIÓN

    Solo los diccionarios de la sección MySpell para OpenOffice.org v2.0.1 o anterior, son compatibles. Como los diccionarios ahora son archivos de archivo, se recomienda que verifique el archivo después de descargarlo.

  3. Busque los archivos .aff y .dic . Mantener nombre de archivo en minúsculas. Por ejemplo, de_de.aff y de_de.dic.

  4. Cargue los archivos .aff y .dic en el repositorio en /apps/cq/spellchecker/dictionaries.

NOTA

El corrector ortográfico RTE está disponible bajo demanda. No se ejecuta automáticamente cuando empieza a escribir texto.
Para ejecutar el corrector ortográfico, pulse o haga clic en el botón corrector ortográfico de la barra de herramientas. RTE comprueba la ortografía de las palabras y resalta las palabras mal escritas.
Si incorpora cualquier cambio que sugiera el corrector ortográfico, el estado del texto cambia y las palabras mal escritas ya no se resaltan. Para ejecutar el corrector ortográfico, toque o haga clic de nuevo en el botón corrector ortográfico.

Configurar el tamaño del historial para acciones de deshacer y rehacer

RTE permite a los autores deshacer o rehacer algunas de las últimas ediciones. De forma predeterminada, se almacenan 50 ediciones en el historial. Puede configurar este valor según sea necesario.

  1. Dentro del componente, vaya al nodo <rtePlugins-node>/undo. Cree estos nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. En el undo crea la propiedad :

    • Nombre maxUndoSteps
    • Tipo Long
    • Valor número de pasos de deshacer que desea guardar en el historial. El valor predeterminado es 50. Uso 0 para desactivar/rehacer por completo.
  3. Guarde los cambios.

Configuración del tamaño de la pestaña

Cuando se presiona el carácter de tabulación dentro de cualquier texto, se inserta un número predefinido de espacios. de forma predeterminada, se trata de tres espacios de no separación y un espacio.

Para definir el tamaño de la pestaña:

  1. En el componente, vaya al nodo . <rtePlugins-node>/keys. Cree los nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. En el keys crea la propiedad :

    • Nombre tabSize
    • Tipo String
    • Valor el número de caracteres de espacio que se utilizarán en la tabuladora.
  3. Guarde los cambios.

Definir margen de sangría

Cuando la sangría está activada (opción predeterminada), puede definir el tamaño de la sangría:

NOTA

Este tamaño de guión solo se aplica a los párrafos (bloques) del texto; no afecta a la sangría de listas reales.

  1. Dentro del componente, vaya al nodo <rtePlugins-node>/lists. Cree estos nodos si no existen. Para obtener más información, consulte activar un complemento.

  2. En el lists crear el nodo identSize parámetro:

    • Nombre: identSize
    • Tipo: Long
    • Valor: número de píxeles necesarios para el margen de sangría.

Configuración de la altura del espacio editable

Puede definir la altura del espacio editable que se muestra en el cuadro de diálogo del componente. La configuración solo es aplicable cuando se utiliza RTE en un cuadro de diálogo. La configuración no cambia la altura de la ventana de diálogo.

  1. En el ../items/text , en la definición de cuadro de diálogo del componente, cree una propiedad:

    • Nombre height
    • Tipo Long
    • Valor la altura del lienzo de edición en píxeles.
  2. Guarde los cambios.

Configuración de estilos y protocolos para vínculos

Al agregar vínculos en Experience Manager, puede definir los estilos CSS que se van a utilizar y los protocolos que se van a aceptar automáticamente. Para configurar cómo se agregan los vínculos en Experience Manager en otro programa, defina las reglas del HTML.

  1. Con el CRXDE Lite , busque el componente de texto del proyecto.

  2. Crear un nodo en el mismo nivel que <rtePlugins-node>, es decir, cree el nodo bajo el nodo principal de <rtePlugins-node>:

    • Nombre htmlRules
    • Tipo nt:unstructured
    NOTA

    La variable ../items/text tiene la propiedad :

    • Nombre xtype
    • Tipo String
    • Valor richtext

    La ubicación de ../items/text puede variar, dependiendo de la estructura del cuadro de diálogo. Dos ejemplos son /apps/myProject>/components/text/dialog/items/text y /apps/<myProject>/components/text/dialog/items/panel/items/text.

  3. En htmlRules, cree un nodo.

    • Nombre links
    • Tipo nt:unstructured
  4. En el links define las propiedades según sea necesario:

    • Estilo CSS para vínculos internos:

      • Nombre cssInternal
      • Tipo String
      • Valor el nombre de la clase CSS (sin un '.' anterior); por ejemplo, cssClass en lugar de .cssClass)
    • Estilo CSS para vínculos externos

      • Nombre cssExternal
      • Tipo String
      • Valor el nombre de la clase CSS (sin un '.' anterior); por ejemplo, cssClass en lugar de .cssClass)
    • Matriz válida protocolos incluido https://, https://, file://, mailto:, y otros,

      • Nombre protocols
      • Tipo String[]
      • Valor s) uno o más protocolos
    • defaultProtocol (propiedad del tipo Cadena): Protocolo que se utilizará si el usuario no especificó uno explícitamente.

      • Nombre defaultProtocol
      • Tipo String
      • Valor(s) uno o más protocolos predeterminados
    • Definición de cómo gestionar el atributo target de un vínculo. Cree un nodo:

      • Nombre targetConfig
      • Tipo nt:unstructured

      En el nodo targetConfig: defina las propiedades requeridas:

      • Especifique el modo de destino:

        • Nombre mode

        • Tipo String)

        • Valor s) :

          • auto: significa que se elige un objetivo automático

            (especificado por el targetExternal propiedad para vínculos externos o targetInternal para vínculos internos).

          • manual: no aplicable en este contexto

          • blank: no aplicable en este contexto

      • El objetivo para los vínculos internos:

        • Nombre targetInternal
        • Tipo String
        • Valor el destino de los vínculos internos (solo se utiliza cuando el modo es auto)
      • El destino de los vínculos externos:

        • Nombre targetExternal
        • Tipo String
        • Valor el destino de los vínculos externos (solo se usa cuando el modo es auto).
  5. Guarde todos los cambios.

En esta página