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 la propiedad features. Puede configurar la propiedad features para activar o desactivar 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 otras configuraciones de RTE, consulte Configuración del editor de texto enriquecido.

NOTA

Al trabajar con CRXDE Lite, se recomienda guardar los cambios regularmente mediante Guardar todo opción.

Activar un complemento y configurar la propiedad features

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, justify, y control Los complementos de y todas sus funciones están habilitados en RTE.

NOTA

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

  1. Con CRXDE Lite, busque el componente de texto para su 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

    • Ambos tienen la siguiente propiedad:

      • Nombre name
      • Tipo String
      • Valor ./text
  3. Según la interfaz que configure para, 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 de complemento del complemento requerido

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

Habilitar todas las funciones Habilitar algunas funciones específicas Desactivar todas las funciones
Nombre características características características
Tipo Cadena Cadena[] (multi-cadena; establezca Type en String y haga clic en Multi en el CRXDE Lite) Cadena
Valor * (un asterisco) se establece en uno o más valores de función -

Comprensión del complemento findreplace

El 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. Esto permitirá al autor revisar el texto que reemplazará. Si los usuarios hacen clic en reemplazar todo, el cuadro de diálogo se cierra y muestra el número de reemplazos realizados.

Configuración de los modos de pegado

Al utilizar RTE, los autores pueden pegar el 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 marcado no deseado.

  • 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 insertarlo 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 pegado de texto desde otro origen, como una página web o MS Excel, y sólo conserva un formato parcial.

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

Puede proporcionar algunos, todos o ninguno de estos tres iconos a los 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 la funcionalidad del 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 activación de un complemento si el nodo no existe.
  3. Cree el features propiedad en el edit y agregue una o más de las funciones. Guarde todos los cambios.

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

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

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

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

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

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

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

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

    • Nombre defaultPasteMode
    • Tipo String
    • Valor Uno de los modos de pegado requeridos browser, plaintext, o wordhtml.

Configurar los formatos permitidos al pegar contenido

La función pegar como Microsoft Word (paste-wordhtmlAEM El modo ) se puede configurar aún más para que pueda definir explícitamente qué estilos se permiten al pegar elementos desde otro programa, como Microsoft Word, o desde el que se pueden pegar los elementos desde otro programa, o desde el que se pueden pegar los elementos de forma predeterminada.

AEM Por ejemplo, si solo se deben permitir formatos en negrita y listas al pegar en la lista de distribución, puede filtrar los demás formatos. Esto se denomina filtrado de pegado configurable y se puede hacer para lo siguiente:

En el caso de los vínculos, también puede definir los protocolos que se aceptan automáticamente.

AEM Para configurar los formatos que se permiten al pegar texto en los archivos de texto desde otro programa, haga lo siguiente:

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

  2. Cree un nodo en edit nodo en el que se guardarán las reglas de pegado de HTML:

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

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

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

    Todas las propiedades son de Tipo Boolean, por lo 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. Otros formatos también se pueden definir mediante una serie de otras propiedades o nodos, también aplicados a la variable htmlPasteRules nodo. Guarde todos los cambios.

Puede utilizar las siguientes propiedades para htmlPasteRules.

Propiedad Tipo Descripción
allowBlockTags Cadena Define la lista de etiquetas de bloque permitidas. Algunas etiquetas de bloque posibles son:
  • titulares (h1, h2, h3)
  • párrafos p)
  • listas (ol, ul)
  • tablas (tabla)
fallbackBlockTag Cadena Define la etiqueta de bloque utilizada para cualquier bloque que tenga una etiqueta de bloque no incluida en allowBlockTags. p en la mayoría de los casos.
tabla nt:unstructured Define el comportamiento al pegar tablas. Este nodo debe tener la propiedad allow (tipo Boolean) para definir si se permite pegar tablas. Si la opción Permitir está establecida en false, debe especificar la propiedad ignoreMode (escriba Cadena) para definir cómo se administra el contenido de tabla pegado. Valores válidos para ignoreMode son:
  • remove: elimina el contenido de la tabla.
  • paragraph: convierte las celdas de la tabla en párrafos.
list nt:unstructured Define el comportamiento al pegar listas. Debe tener la propiedad allow (tipo booleano) para definir si se permite pegar listas. If allow se establece en false, debe especificar la propiedad ignoreMode (escriba Cadena) para definir cómo gestionar cualquier contenido de lista pegado. Valores válidos para ignoreMode son:
  • remove: elimina el contenido de la lista.
  • paragraph: convierte los elementos de lista en párrafos.

Un ejemplo de un válido htmlPasteRules La estructura está debajo de.

"htmlPasteRules": {
    "allowBasics": {
        "italic": true,
        "link": true
    },
    "allowBlockTags": [
        "p", "h1", "h2", "h3"
    ],
    "list": {
        "allow": false,
        "ignoreMode": "paragraph"
    },
    "table": {
        "allow": true,
        "ignoreMode": "paragraph"
    }
}

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 estilos CSS. El contenido estilizado se adjunta como span etiquetas con el 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 estilos a los autores, haga lo siguiente:

  • Active el selector desplegable Estilo.
  • Especifique la ubicación de las hojas de estilo.
  • Especifique los estilos individuales que se pueden seleccionar en la lista desplegable Estilo.

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

NOTA

Puede definir estilos para tablas o celdas de tabla. Estas configuraciones requieren procedimientos independientes.

Habilitar la lista desplegable de selectores de estilo

Para ello, habilite el complemento estilos.

  1. En el componente, vaya 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 el features propiedad en el 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 estilos

A continuación, especifique las ubicaciones de las hojas de estilos 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[] (varias cadenas; haga clic en Múltiple en CRXDE)
    • Valor(es) Ruta de acceso y nombre de archivo de cada hoja de estilos que desee incluir. Utilice las rutas del repositorio.
    NOTA

    Se pueden agregar referencias a hojas de estilos adicionales en cualquier momento posterior.

  3. Guarde todos los cambios.

NOTA

Al utilizar RTE en un cuadro de diálogo (IU clásica), es posible que desee 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 es posible que desee emular este contexto para mejorar la experiencia WYSIWYG.

El editor de texto enriquecido utiliza un elemento DOM contenedor con un ID de CQrte que pueden utilizarse para proporcionar diferentes estilos de visualización 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, vaya al nodo <rtePlugins-node>/styles, tal como se crea en Activación del selector desplegable de estilo.

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

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

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

    • Nombre cssName
    • Tipo String
    • Valor El nombre de la clase CSS (sin '.' anterior; por ejemplo, cssClass en lugar de .cssClass)
  5. Añadir la propiedad text al mismo nodo; 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.

Configuración de RTE para saltos de palabra óptimos en japonés

AEM Los autores que utilizan la función de creación de contenido en japonés pueden aplicar un estilo a los caracteres para evitar saltos de línea donde no sea necesario un salto de línea. Esto permite a los autores dejar que las frases se rompan en la posición deseada. El estilo de esta funcionalidad se basa en la clase CSS predefinida en la hoja de estilos CSS.

NOTA

AEM Esta función requiere al menos el paquete de servicio 1 de 6.5 de.

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

  1. Cree un nuevo nodo en el nodo Estilos. Consulte especificar un nuevo 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 línea en japonés.

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

    • Nombre: text
      *Tipo:
      String
    • Valor: Japanese word-wrap
  4. Cree una hoja de estilo y especifique su ruta. Consulte especificar la ubicación de la hoja de estilo. Añada 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 poner la función de ajuste de línea en japonés a disposición de los autores

Configuración de 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 la variable paraformat , puede especificar 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 de formato. Entre las etiquetas de bloque de ejemplo se incluye el párrafo estándar <p> y encabezados <h1>, <h2>, etc.

PRECAUCIÓN

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

NOTA

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

Cuando el complemento Formatos de párrafo se activa 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 desplegable Formato del selector.
  • Especifique las etiquetas de bloque que se pueden seleccionar como formatos de párrafo en la lista desplegable.

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

Habilite el selector desplegable Formato

En primer lugar, habilite el complemento de paraformato:

  1. En el componente, vaya 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 el features propiedad en el paraformat nodo:

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

Si el complemento no se sigue configurando, se habilitan los siguientes formatos predeterminados:

  • Párrafo ( <p>)
  • Encabezado 1 ( <h1>)
  • Encabezado 2 ( <h2>)
  • Encabezado 3 ( <h3>)
PRECAUCIÓN

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

Especificar los formatos de párrafo disponibles

Los formatos de párrafo podrán ser seleccionados por:

  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 nodo crear un nuevo nodo, para guardar la lista de formatos:

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

    • Nombre, puede especificar el nombre, pero debe ser adecuado para el formato (por ejemplo, myparagraph, myheading1).
    • Tipo nt:unstructured
  4. A este nodo, agregue la propiedad para definir la etiqueta de bloque utilizada:

    • Nombre tag

    • Tipo String

    • Valor La etiqueta 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 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 requerido.

PRECAUCIÓN

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

Configuración de caracteres especiales

AEM En una instalación estándar de, cuando la variable misctools está habilitado para caracteres especiales (specialchars) una selección predeterminada está disponible inmediatamente para su uso; por ejemplo, los símbolos de copyright y marca comercial.

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

PRECAUCIÓN

Si agrega sus propios caracteres especiales, se anulará la selección predeterminada. Si es necesario, (re-)defina estos caracteres en su propia 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 activación de un complemento.

  2. Cree el features propiedad en el misctools nodo:

    • Nombre features

    • Tipo String[]

    • Valor specialchars

      (o String / * si aplica todas las funciones para este complemento)

  3. En misctools cree un nodo que contenga las configuraciones de caracteres especiales:

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

    • Nombre chars
    • Tipo nt:unstructured
  5. En chars añada un nuevo nodo para guardar 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 HTML del carácter requerido; por ejemplo, &189; para la fracción la 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 acceso a caracteres más especiales.

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

Definir un intervalo de caracteres

  1. Siga los pasos del 1 al 3 de Definición de un solo carácter.

  2. En chars agregue un nuevo nodo para guardar la definición del intervalo 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 (denominado según su intervalo especial de caracteres), agregue las dos propiedades siguientes:

    • Nombre rangeStart

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

    • Nombre rangeEnd

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

  4. Guarde los cambios.

    Por ejemplo, defina un intervalo de 9998 10000 le proporcione los siguientes caracteres.

    En CRXDE, defina un rango de caracteres que estará disponible en RTE

    Imagen: en CRXDE, defina un intervalo de caracteres que deben estar disponibles en RTE

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

Configurar estilos de tabla

Los estilos suelen aplicarse en el texto, pero también se puede aplicar un conjunto independiente de estilos en una tabla o en algunas celdas de la tabla. Estos estilos están disponibles para los autores desde el cuadro Selector de estilo en el 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 el pegado de tablas en o desde el componente RTE depende del explorador. No es compatible de serie con todos los exploradores. Puede obtener resultados variados según la estructura de la tabla y el explorador. 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, el diseño de la tabla no se conserva.

  1. En el componente, vaya 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 el features propiedad en el table nodo:

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

    Si no desea activar todas las funciones de tabla, puede crear el features propiedad como:

    • Tipo String[]
    • Valor(s) uno, o ambos, de los siguientes, según sea necesario:
      • table para permitir la edición de propiedades de tabla; incluidos los estilos.
      • cellprops para permitir la edición de las propiedades de la celda, incluidos los estilos.
  3. Defina la ubicación de las hojas de estilos CSS para hacer referencia a ellas. Consulte Especificar la ubicación de la hoja de estilos ya que es lo mismo que al definir estilos para texto. La ubicación puede definirse si ha definido otros estilos.

  4. En el table nodo cree los siguientes nodos nuevos (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 (disponible en Propiedades de celda):

      • Nombre cellStyles
      • Tipo cq:WidgetCollection
  5. Cree un nuevo nodo (en la variable 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 hará 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 aparecerá en el selector desplegable

      • 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 fines de accesibilidad

A veces, puede crear tablas de datos sin texto visual en un encabezado de 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 diversas necesidades a comprender el propósito de la columna.

Para mejorar la accesibilidad en estos casos, 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 vista previa. Para ayudar a los autores a identificar los 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 Style que se aplica en la celda de encabezado oculto cuando se edita RTE.

Si especifica las cadenas CSS y Style 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 Style.

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 oculta en el modo de vista previa.
  • hiddenHeaderStyle: especifica una cadena Style que se aplica en la celda de encabezado oculto en el modo de vista previa.

Si especifica las cadenas CSS y Style 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 Style.

Agregar diccionarios para el corrector ortográfico

Cuando se activa el complemento corrector ortográfico, 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. el /en/ La rama de se marca como Inglés, la /de/ sucursal en alemán.

NOTA

El mensaje Spell checking failed se ve si se intenta una comprobación para un idioma que no está instalado. Los diccionarios estándar se encuentran en /libs/cq/spellchecker/dictionaries, junto con los archivos léame adecuados. No modifique los archivos.

AEM Una instalación estándar de la incluye los diccionarios para inglés americano (en_us) e inglés británico (en_gb). Para agregar más diccionarios, siga estos pasos.

  1. Navegue hasta la página https://extensions.openoffice.org/.

  2. Realice una de las siguientes acciones para buscar un diccionario del idioma que haya elegido:

    • Busque el diccionario del idioma que haya elegido. En la página del diccionario, busque el vínculo a la página web de origen o del autor original. Busque los archivos de diccionario para v2.x en una página de este tipo.
    • Busque los archivos de diccionario v2.x en https://wiki.openoffice.org/wiki/User:Khirano/Dictionaries.
  3. Descargue el archivo con las definiciones de ortografía. Extraiga el contenido del archivo en su sistema de archivos.

    PRECAUCIÓN

    Solo los diccionarios de MySpell es compatible con el formato de OpenOffice.org v2.0.1 o anterior. Como los diccionarios ahora son archivos de almacenamiento, se recomienda verificarlos después de la descarga.

  4. Busque los archivos .aff y .dic. Mantenga el nombre del archivo en minúsculas. Por ejemplo, de_de.aff y de_de.dic.

  5. 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, haga clic en Corrector ortográfico en la barra de herramientas. RTE revisa 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 dejan de resaltarse. Para ejecutar el corrector ortográfico, toque o haga clic en el botón Corrector ortográfico de nuevo.

Configuración del tamaño del historial para acciones de deshacer y rehacer

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

  1. En el componente, vaya 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 undo nodo crear 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 por completo deshacer/rehacer.
  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, son tres espacios sin saltos 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 activación de un complemento.

  2. En el keys nodo crear la propiedad:

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

Establecer margen de sangría

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

NOTA

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

  1. En el componente, vaya 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 lists nodo crear el identSize parámetro:

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

Configurar la altura del espacio editable

NOTA

Esto solo es aplicable cuando se utiliza el RTE en un cuadro de diálogo (no en la edición in situ en la IU clásica).

Puede definir la altura del espacio editable que se muestra en el cuadro de diálogo del componente:

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

    • Nombre height
    • Tipo Long
    • Valor altura del lienzo de edición en píxeles.
    NOTA

    Esto no cambia la altura de la ventana de diálogo.

  2. Guarde los cambios.

Configuración de estilos y protocolos para vínculos

AEM Al añadir vínculos en, puede definir lo siguiente:

  • Estilos CSS que se van a utilizar
  • Los protocolos aceptados automáticamente

AEM Para configurar cómo se añaden los vínculos en los vínculos desde otro programa, defina las reglas del HTML de.

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

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

    • Nombre htmlRules
    • Tipo nt:unstructured
    NOTA

    El ../items/text tiene la propiedad:

    • Nombre xtype
    • Tipo String
    • Valor richtext

    La ubicación del ../items/text El nodo 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 nuevo nodo.

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

    • Estilo CSS para vínculos internos:

      • Nombre cssInternal
      • Tipo String
      • Valor 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
      • Valor el nombre de la clase CSS (sin '.'); por ejemplo, cssClass en lugar de .cssClass)
    • Matriz de válidos protocolos. Los protocolos admitidos son http://, https://, file://, y mailto:.

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

      • Nombre defaultProtocol
      • Tipo String
      • Valor(s) uno o más protocolos predeterminados
    • Definición de cómo gestionar el atributo de destino de un vínculo. Cree un nuevo 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 destinatario automático

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

          • manual: no aplicable en este contexto

          • blank: no aplicable en este contexto

      • El destino de los vínculos internos:

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

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

En esta página