Configurar los complementos del editor de texto enriquecido

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

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

NOTA

Cuando trabaje con CRXDE Lite, se recomienda guardar los cambios de forma regular mediante la opción Guardar todo.

Active un complemento y configure la propiedad de características

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, los complementos format, link, list, justify y control y todas sus funciones están activadas en RTE.

NOTA

El nodo rtePlugins correspondiente se denomina <rtePlugins-node> para evitar la duplicación en este artículo.

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

  2. Cree el nodo principal de <rtePlugins-node> si no existe, antes de configurar los complementos 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. Según la interfaz para la que esté configurando, cree un nodo <rtePlugins-node>, si no existe:

    • Nombre rtePlugins
    • Tipo nt:unstructured
  4. Debajo de esto, 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 pautas para configurar la propiedad features.

Habilitar todas las funciones Habilite algunas funciones específicas. Desactive todas las funciones.
Nombre características características características
Tipo Cadena String (multi-string; definir Tipo String y hacer clic Multi en CRXDE Lite) Cadena
Value * (un asterisco) Se establece en uno o varios valores de función. -

Comprender el complemento Findreplace

El complemento findreplace no necesita ninguna configuración. Funciona de la caja.

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 seguir haciendo 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 restablece al principio del texto.

El cuadro de diálogo Buscar y reemplazar se vuelve transparente cuando se hace clic en Buscar y se vuelve opaco cuando se hace 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 cierra y muestra el número de reemplazos realizados.

Configurar los modos de pegado

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

  • Modo del explorador: Pegue texto mediante la implementación de pegado predeterminada del explorador. No es un método recomendado, ya que podría 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 el componente Experience Manager.

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

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

Puede proporcionar algunos, todos o ninguno de estos tres iconos a sus autores en la barra de herramientas 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 a su 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 propiedad features en el nodo edit y agregue una o más de las características. Guarde todos los cambios.

Configurar el comportamiento del icono Pegar (Ctrl+V) y el acceso directo

Puede preconfigurar el comportamiento del icono Pegar (Ctrl+V) mediante los siguientes pasos. 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 siguientes tres tipos de casos de uso:

  • Pegue texto mediante la implementación de pegado predeterminada del explorador. No es un método recomendado, ya que podría introducir marcas no deseadas. Configurado con browser a continuación.

  • Pegue el contenido del portapapeles como texto sin formato. Elimina todos los elementos de estilo y formato del contenido copiado antes de insertarlos en el componente Experience Manager. Configurado con plaintext a continuación.

  • Pegue el texto, incluidas las tablas, con formato al copiar desde MS Word. No se admite copiar y pegar texto de otro origen, como una página web o MS Excel, y solo se conserva el formato parcial. Configurado con wordhtml a continuación.

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

  2. En el nodo edit, cree una propiedad con los siguientes detalles:

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

Configure los formatos permitidos al pegar contenido

El modo de pegar como Microsoft Word (paste-wordhtml) se puede configurar más para permitir explícitamente algunos estilos al pegar en Experience Manager desde 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 realizar para ambos:

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

Para configurar qué formatos se permiten al pegar texto en Experience Manager desde otro programa:

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

  2. Cree un nodo bajo el nodo edit para mantener las reglas de pegado 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 el nodo allowBasics:

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

    Todas las propiedades son de Tipo Boolean, por lo que en el Valor correspondiente 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 true y se acepta el formato.

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

Propiedad Tipo Descripción
allowBlockTags String Define la lista de las 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. Generalmente, p basta.
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 contenido de tabla y paragraph para convertir celdas de tabla en párrafos.
list nt:unstructured Define el comportamiento al pegar listas. Debe tener la propiedad allow (tipo Boolean) para definir si se permite pegar listas. Si allow se establece en false, especifique la propiedad ignoreMode (escriba String) para definir cómo administrar cualquier contenido de lista pegado. Los valores válidos para ignoreMode son remove que elimina el contenido de lista y paragraph que convierte los elementos de lista en párrafos.

A continuación se muestra un ejemplo de una estructura htmlPasteRules válida:

"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.

Configurar 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 estilo CSS. El contenido estilizado se incluye en etiquetas span utilizando el atributo class para hacer referencia a la clase CSS. Por ejemplo:

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

Cuando el complemento Estilos está activado 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 solo 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 del selector desplegable Estilo

Esto se realiza habilitando el complemento de estilos.

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

  2. Cree la propiedad features en el nodo styles:

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

NOTA

Una vez activado 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 porque no hay estilos configurados.

Especifique la ubicación de la hoja de estilo

A continuación, especifique las ubicaciones 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ñada la propiedad externalStyleSheets en el nodo principal de <rtePlugins-node>:

    • Nombre externalStyleSheets
    • Type String[] (multi-string; haga clic en ​Multiin CRXDE)
    • Valores La ruta y el 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 hojas de estilo 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 la vista y edición:

#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, navegue al nodo <rtePlugins-node>/styles, tal como se creó en Habilitación del selector desplegable de estilo.

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

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

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

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

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

    Repita los pasos anteriores para cada estilo requerido.

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

Los autores que utilicen Experience Manager para crear contenido en japonés pueden aplicar un estilo a los caracteres para evitar saltos de línea cuando no se requiera un salto de línea. Esto permite a los autores dejar que las oraciones rompan en la posición deseada. El estilo de esta funcionalidad se basa en la clase CSS predefinida en la hoja de estilo 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 de estilos. Consulte especificar un estilo.

    • Nombre: jpn-word-wrap
    • Tipo: nt:unstructure
  2. Añada la propiedad cssName en el 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 un . anterior)
  3. Añada 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 especifique la ubicación de la hoja de estilo. Añada el siguiente contenido en 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

Configurar los formatos de párrafo

Cualquier texto creado en RTE se coloca dentro de una etiqueta de bloque, siendo el valor predeterminado <p>. Al habilitar el complemento paraformat, se especifican etiquetas de bloque adicionales que se pueden asignar a los párrafos mediante una lista de selección desplegable. 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 Formato. Las etiquetas de bloque de ejemplo incluyen, entre otras, el párrafo estándar <p> y los 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, por ejemplo una etiqueta <hr>, no se puede asignar a un párrafo, no es un caso de uso válido para un complemento paraformat.

Cuando el complemento Formatos de párrafo está activado 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:

  • Habilite la lista del selector emergente Formato.
  • Especifique las etiquetas de bloque que se pueden seleccionar como formatos de párrafo en el menú emergente.

Para las reconfiguraciones posteriores, digamos para agregar más formatos, siga solamente la parte relevante de las instrucciones.

Habilitar el selector desplegable Formato

Para habilitar el complemento paraformat, siga estos pasos:

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

  2. Cree la propiedad features en el nodo paraformat:

    • 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 se elimina la etiqueta <p>, el autor del contenido no puede seleccionar la opción Formatos de párrafo aunque haya otros formatos configurados.

Especifique 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, navegue al nodo <rtePlugins-node>/paraformat, tal como se creó en Habilitación del selector desplegable de formato.

  2. En el nodo paraformat cree un nodo para mantener la lista de formatos:

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

    • Nombre, puede especificar el nombre, pero debería ser adecuado para el formato (por ejemplo, mipárrafo, miencabezado1).
    • Tipo nt:unstructured
  4. A este nodo, agregue la propiedad para definir la etiqueta de bloque utilizada:

    • Nombre tag

    • Tipo String

    • ​ValueEtiqueta de bloque para el formato; por ejemplo: p, h1, h2, etc.

      No es necesario introducir los corchetes angulares delimitadores.

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

    • Nombre description
    • Tipo String
    • ​ValorTexto 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 requerido.

PRECAUCIÓN

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

Configurar caracteres especiales

En una instalación estándar Experience Manager, cuando el complemento misctools está habilitado para caracteres especiales (specialchars), inmediatamente se encuentra disponible una selección predeterminada para su uso; por ejemplo, los símbolos de 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

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

Definir un solo carácter

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

  2. Cree la propiedad features en el nodo misctools:

    • Nombre features

    • Tipo String[]

    • Valor specialchars

      (o String / * si se aplican todas las características para 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 mantener 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
    • ​Valora la representación 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. Vea el ejemplo de la mitad más abajo. Repita los pasos anteriores para que los autores tengan más caracteres especiales disponibles.

En CRXDE, agregue un solo carácter para que esté disponible en la

Defina 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 rango 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
      ​Valore la presentación 🔗 Unicode (decimal) del primer carácter del rango

    • Nombre rangeEnd

      Tipo Long
      ​Valore la presentación 🔗 Unicode (decimal) del último carácter del rango

  4. Guarde los cambios.

    Por ejemplo, si define un intervalo de 9998 a 10000, 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 autores pueden ver los caracteres especiales disponibles en RTE en una

Configurar estilos de tabla

Los estilos se suelen aplicar al texto, pero también se puede aplicar un conjunto independiente de estilos a una tabla o a unas pocas celdas de la tabla. Estos estilos están disponibles para los autores en el cuadro de selección Estilo del cuadro de diálogo Propiedades de celda o Propiedades de tabla. Los estilos están disponibles al editar una tabla dentro de un componente Texto (o derivado) y no en el componente Tabla estándar.

NOTA

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

NOTA

La copia y pegado de tablas en o desde el componente RTE depende del explorador. No se admite de forma predeterminada para todos los exploradores. Puede obtener resultados variados según la estructura de tabla y el explorador. Por ejemplo, al copiar y pegar 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, navegue al nodo <rtePlugins-node>/table. Cree los nodos si no existen. Para obtener más información, consulte activación de un complemento.

  2. Cree la propiedad features en el nodo table:

    • Nombre features
    • Tipo String
    • Valor *
    NOTA

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

    • Tipo String[]
    • Los valores son uno o ambos de los siguientes, según sea necesario:
      • table permitir la edición de propiedades de 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 hacer referencia a ellas. Consulte Especificación de la ubicación de la hoja de estilo ya que es la misma que al definir estilos para texto. La ubicación se puede definir si se han definido otros estilos.

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

    • Para definir estilos para toda la tabla (disponible en Propiedades de tabla):

      • Nombre tableStyles
      • Tipo cq:WidgetCollection
    • Para definir estilos para celdas individuales (disponibles en Propiedades de celda),

      • Nombre cellStyles
      • Tipo cq:WidgetCollection
  5. Cree un nodo (bajo el nodo tableStyles o cellStyles 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
      • ​Valore el nombre de la clase CSS (sin un precedente ., por ejemplo, cssClass en lugar de .cssClass)
    • Para definir un texto descriptivo que aparecerá en el selector emergente,

      • Nombre text
      • Tipo String
      • ​Valor del texto que aparece en la lista de selección
  7. Guarde todos los cambios.

Repita los pasos anteriores para cada estilo requerido.

Configurar encabezados ocultos en tablas para accesibilidad

A veces, puede crear tablas de datos sin texto visual en un encabezado de columna suponiendo que el propósito del encabezado se vea implicado 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 de encabezado para permitir que los lectores de pantalla y otras tecnologías de asistencia puedan ayudar a los lectores con diversas 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 opciones de configuración relacionadas con encabezados ocultos en tablas. Esta configuración permite aplicar estilos CSS a 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 cadena CSS y la cadena de 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 de estilo.

Para ayudar a los autores a aplicar CSS en encabezados ocultos en el modo de previsualización, 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 modo de previsualización.
  • hiddenHeaderStyle:: Especifica una cadena de estilo que se aplica en la celda de encabezado oculto en modo de previsualización.

Si especifica la cadena CSS y la cadena de 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 de estilo.

Añadir diccionarios para el corrector ortográfico

Cuando se activa el complemento de revisión de ortografía, RTE utiliza diccionarios para cada idioma adecuado. A continuación, se seleccionan según el idioma del sitio web tomando la propiedad language del subárbol o extrayendo el idioma de la dirección URL; por ejemplo. la rama /en/ se marca como Inglés, la rama /de/ como Alemán.

NOTA

El mensaje "Error al revisar la ortografía". se ve si se intenta comprobar 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 se admiten los diccionarios en formato MySpell para OpenOffice.org v2.0.1 o anterior. Dado que los diccionarios ahora son archivos de archivo, se recomienda que verifique el archivo después de descargarlo.

  3. Busque los archivos .aff y .dic. Mantenga el nombre del 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 a petición. No se ejecuta automáticamente al escribir texto con inicio.
Para ejecutar el corrector ortográfico, toque 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 las acciones de deshacer y rehacer

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

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

  2. En el nodo undo, cree la propiedad:

    • Nombre maxUndoSteps
    • Tipo Long
    • ​Valore el número de pasos de deshacer que desea guardar en el historial. El valor predeterminado es 50. Utilice 0 para desactivar completamente la acción de deshacer/rehacer.
  3. Guarde los cambios.

Configure el tamaño de la ficha

Cuando se presiona el carácter de tabulación dentro de cualquier texto, se inserta un número predefinido de espacios; de forma predeterminada, hay tres espacios sin saltos y un espacio.

Para definir el tamaño de la ficha:

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

  2. En el nodo keys, cree la propiedad:

    • Nombre tabSize
    • Tipo String
    • ​Valor del número de caracteres de espacio que se utilizarán para el tabulador.
  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 sangría solo se aplica a los párrafos (bloques) de texto; no afecta a la sangría de listas reales.

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

  2. En el nodo lists, cree el parámetro identSize:

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

Configurar 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 se aplica 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 nodo ../items/text, en la definición de cuadro de diálogo del componente, cree una propiedad:

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

Configurar estilos y protocolos para vínculos

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

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

  2. Cree 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

    El nodo ../items/text tiene la propiedad:

    • Nombre xtype
    • Tipo String
    • Valor richtext

    La ubicación del nodo ../items/text puede variar según 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 nodo links, defina las propiedades como sea necesario:

    • Estilo CSS para vínculos internos:

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

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

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

      • Nombre defaultProtocol
      • Tipo String
      • Valores de uno o más protocolos predeterminados
    • Definición de cómo gestionar el atributo de destinatario de un vínculo. Crear un nodo:

      • Nombre targetConfig
      • Tipo nt:unstructured

      En el nodo targetConfig: defina las propiedades requeridas:

      • Especifique el modo de destinatario:

        • Nombre mode

        • Tipo String)

        • Valores:

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

            (especificada por la propiedad targetExternal para vínculos externos o targetInternal para vínculos internos).

          • manual:: no aplicable en este contexto

          • blank:: no aplicable en este contexto

      • El destinatario para los vínculos internos:

        • Nombre targetInternal
        • Tipo String
        • ​Valorar el destinatario de los vínculos internos (solo se utiliza cuando el modo es auto)
      • Destinatario para vínculos externos:

        • Nombre targetExternal
        • Tipo String
        • ​Valore el destinatario de los vínculos externos (solo se utiliza cuando el modo es auto).
  5. Guarde todos los cambios.

En esta página