Componente Texto text-component
El componente Texto del componente principal es un componente de composición y edición de texto enriquecido que incluye la edición in situ.
Uso usage
El componente Texto ofrece un editor de texto enriquecido robusto que permite editar texto fácilmente en un editor en línea simplificado, así como en formato de pantalla completa.
El cuadro de diálogo de edición incluye la edición en línea con opciones limitadas con la funcionalidad completa disponible en el cuadro de diálogo de edición en pantalla completa. Mediante el cuadro de diálogo de diseño se pueden configurar opciones de formato de texto como encabezados, caracteres especiales y estilos de párrafo para la plantilla del autor del contenido.
Versión y compatibilidad version-and-compatibility
La versión actual del componente Texto es la versión 2, que se introdujo con la versión 2.0.0 de los componentes principales en enero de 2018 y se describe en este documento.
La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.
Para obtener más información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.
Salida del componente de ejemplo sample-component-output
Para experimentar el componente Texto y ver ejemplos de sus opciones de configuración, así como la salida HTML y JSON, visite la Biblioteca de componentes.
Detalles técnicos technical-details
La documentación técnica más reciente sobre el componente Texto se encuentra en GitHub.
Puede encontrar más información sobre el desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.
El componente Texto y el editor de texto enriquecido the-text-component-and-the-rich-text-editor
El componente Texto de los componentes principales aprovecha el Editor de texto enriquecido de AEM (RTE). El RTE proporciona a los autores de contenido una amplia gama de funciones para editar su contenido de texto. El RTE es muy flexible en su configuración y ofrece una serie de opciones. Puede encontrar más información sobre cómo se puede configurar el RTE en los artículos Configurar el editor de texto enriquecido y Configurar los complementos del editor de texto enriquecido.
El resto de este artículo muestra la configuración estándar del componente Texto de componentes principales con la configuración del RTE predeterminada.
Cuadro de diálogo de edición edit-dialog
El cuadro de diálogo de edición ofrece las herramientas de formato de texto enriquecido estándar que esperaría un usuario para componer textos.
Negrita
Se utiliza para aplicar formato de negrita al texto seleccionado o para dar formato negrita al texto introducido después del cursor.
Ctrl+B se puede utilizar como método abreviado de teclado.
Cursiva
Se utiliza para aplicar formato de cursiva al texto seleccionado o para aplicar cursiva al texto introducido después del cursor.
Ctrl+I puede utilizarse como método abreviado de teclado.
Subrayado
Se utiliza para aplicar formato subrayado al texto seleccionado o para subrayar el texto introducido después del cursor.
Ctrl+U puede utilizarse como método abreviado de teclado.
Subíndice
Se utiliza para dar formato al texto seleccionado o al texto introducido después del cursor como subíndice.
Superíndice
Se utiliza para dar formato de superíndice al texto seleccionado o al texto introducido después del cursor.
Pegar como texto
Pega cualquier texto copiado como texto sin formato.
Al seleccionar esta opción, se abre una ventana en la que el texto se puede pegar como texto sin formato como vista previa antes de insertarlo en el texto. Acepte pulsando o haciendo clic en la marca de verificación, cancele la acción tocando o haciendo clic en la x.
Pegar desde Word
Al seleccionar esta opción, se abrirá una ventana en la que el texto se puede pegar manteniendo su formato como vista previa antes de insertarlo en el texto. Acepte pulsando o haciendo clic en la marca de verificación, cancele la acción tocando o haciendo clic en la x.
Hipervínculo
Utilice esta opción para convertir el texto seleccionado en un hipervínculo o modificar un vínculo ya definido. Esta opción solo está activa cuando ya se ha seleccionado el texto y se abre una ventana con opciones adicionales para configurar el vínculo.
-
Especifique la ruta
- Utilice el cuadro de diálogo Abrir selección para elegir una ruta en AEM
- Si el vínculo no está dentro de AEM, introduzca la dirección URL absoluta
- Las rutas no absolutas se interpretan como relativas a AEM
-
Escriba un texto descriptivo alternativo para el vínculo
-
Seleccione el comportamiento del vínculo
- Destino
- Misma pestaña
- Nueva pestaña
- Marco principal
- Marco superior
Pulse o haga clic en la marca de verificación para aplicar el vínculo o la x para cancelar.
Desvincular
Utilice esta opción para quitar un vínculo ya aplicado al texto seleccionado. Esta opción solo está activa cuando ya se ha seleccionado un vínculo.
Buscar
Utilice esta opción para buscar en el texto ocurrencias de una cadena de texto especificada. Al seleccionar esta opción, se abre una ventana para especificar las opciones de búsqueda.
Escriba el texto que quiera buscar y toque o haga clic en Buscar para comenzar. Pulse o haga clic en la x para cancelar.
Si desea buscar una coincidencia exacta teniendo en cuenta las minúsculas y las mayúsculas, seleccione la opción Coincidir minúsculas y mayúsculas antes de iniciar la búsqueda.
Si se encuentra una coincidencia, esta se resaltará y el cuadro de diálogo de búsqueda se atenuará. Pulse o haga clic de nuevo en el botón Buscar del cuadro de diálogo atenuado para buscar la siguiente ocurrencia.
Si no se encuentran más ocurrencias, se mostrará un mensaje y la búsqueda se reiniciará desde el principio del texto.
Reemplazar
Utilice esta opción para buscar en el texto ocurrencias de una cadena de texto especificada y reemplazarlas por otra cadena. Al seleccionar esta opción, se abrirá una ventana para especificar las opciones de búsqueda y de reemplazo.
Introduzca el texto para que quiera buscar, así como el texto con el que debe reemplazarse.
- Pulse o haga clic en Buscar para comenzar la búsqueda. Pulse o haga clic en la x para cancelar.
- Si desea buscar una coincidencia exacta teniendo en cuenta las minúsculas y las mayúsculas, seleccione la opción Coincidir minúsculas y mayúsculas antes de iniciar la búsqueda.
- Seleccione Reemplazar todo para reemplazar todas las apariciones del texto a la vez.
Si se encuentra una coincidencia, esta se resaltará y el cuadro de diálogo de búsqueda se atenuará. Vuelva a hacer clic en el botón Buscar del cuadro de diálogo atenuado para buscar la siguiente ocurrencia o seleccione el botón Reemplazar para reemplazar el texto resaltado y coincidente. Tenga en cuenta que el botón Reemplazar solo estará activo una vez que se haya encontrado una coincidencia.
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á.
Alinear texto a la izquierda
Se utiliza para alinear el texto con el margen izquierdo.
Centrar texto
Se utiliza para centrar el texto.
Alinear texto a la derecha
Se utiliza para alinear el texto con el margen derecho.
Viñeta
Se utiliza para dar formato al texto seleccionado como una lista con viñetas o comenzar la inserción de una lista con viñetas después del cursor.
Para finalizar una lista con viñetas, toque o haga clic en el botón Viñeta de nuevo o introduzca dos retornos de carro.
Numeración
Se utiliza para dar formato al texto seleccionado como una lista numerada o comenzar la inserción de una lista numerada después del cursor.
Para finalizar una lista numerada, toque o haga clic en el botón Numeración de nuevo o introduzca dos retornos de carro.
Anular sangría
Se utiliza para reducir el nivel de sangría del texto seleccionado o del texto introducido después del cursor.
Solo se activará si el texto o la posición seleccionados del cursor ya tienen sangría.
Sangría
Se utiliza para aumentar el nivel de sangría del texto seleccionado o del texto introducido después del cursor.
Tabla
Se utiliza para insertar una tabla en el texto. Al seleccionar esta opción, se abrirá una ventana para especificar los detalles de la tabla.
-
Columnas: el número de columnas de la tabla (obligatorio)
-
Filas: el número de filas de la tabla (obligatorio).
-
Anchura
La anchura de la tabla -
Altura
La altura de la tabla -
Margen de celdas: el espacio alrededor del contenido de la celda
-
Espaciado de celdas: el espacio entre celdas
-
Borde: el peso de las líneas de borde de la tabla.
-
Si para el encabezado de la tabla:
- Debe usarse la primera fila
- Debe usarse la primera columna
- Debe usarse la primera fila y la primera columna
- O no se debe utilizar ningún encabezado
-
-
Pie: el pie de la tabla.
Revisar ortografía
Se utiliza para revisar la ortografía del contenido del texto. Los posibles errores ortográficos se subrayarán con líneas rojas y rotas.
Para obtener más información sobre la revisión ortográfica y la personalización de los diccionarios de revisión ortográfica, consulte el documento Configurar los complementos del editor de texto enriquecido.
Caracteres especiales special-characters
Se utiliza para insertar caracteres especiales en el texto. Al seleccionar esta opción, se abrirá una ventana en la que se mostrarán los caracteres disponibles.
Pulse o haga clic en el carácter deseado para insertarlo en el texto después del cursor. Se pueden insertar varios caracteres. Pulse o haga clic en la x para cerrar la ventana de selección.
Modificar código fuente
Se utiliza para ver y modificar el origen HTML del texto.
Pulse o haga clic en el icono Modificar código fuente para cambiar el contenido del texto desde la vista con formato para ver el HTML sin procesar. En este modo, todas las demás opciones de formato están desactivadas. Pulse o haga clic en el icono Modificar código fuente de nuevo para volver a la vista con formato.
Formato de párrafo
Se utiliza para aplicar formato de párrafo al texto seleccionado o al texto insertado después del cursor. Al seleccionar esta opción, se abrirá una lista desplegable en la que se selecciona el formato de párrafo.
Edición en línea in-line-editing
El componente Texto también se puede editar en línea, pero debido a limitaciones de espacio, no todas las opciones de formato están disponibles. Para ver todas las opciones, cambie al modo de pantalla completa.
Configuración de un ID setting-id
Esta opción permite controlar el identificador único del componente en el HTML y en la capa de datos.
- Si se deja en blanco, se generará automáticamente un ID único que se puede encontrar inspeccionando la página resultante.
- Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
- Cambiar el ID puede afectar al seguimiento de CSS, JS y de la capa de datos.
Cuadro de diálogo de diseño design-dialog
El cuadro de diálogo de diseño permite al autor de la plantilla definir qué opciones de formato de texto están disponibles para los autores de contenido.
Pestaña Plugins plugins-tab
La pestaña Plugins se utiliza para habilitar y deshabilitar varias opciones de formato de texto disponibles para los autores de contenido.
Características features
Las siguientes funciones se pueden activar o desactivar para el componente.
- Pegar texto sin formato
- Pegar desde Word
- Buscar y reemplazar
- Corrector ortográfico
- Opciones de modificación de la imagen insertada
- Edición de código HTML
Formato formatting
Las siguientes opciones de formato se pueden activar o desactivar para el componente.
- Tabla
- Listas (viñeta, número, menos sangría, más sangría)
- Alineación (izquierda, derecha, centrado)
- Negrita, cursiva, subrayado
- Vinculación (y desvinculación)
- Subíndice/superíndice
Estilos de párrafo paragraph-styles
Los estilos de párrafo se pueden activar o desactivar para el componente. Cuando se activa, se pueden definir los formatos permitidos.
- Pulse o haga clic en el botón Añadir para insertar un nuevo estilo.
- Introduzca el código del estilo y una descripción que se mostrarán en el cuadro de diálogo de edición.
- Para quitar un estilo, toque o haga clic en el botón Eliminar.
- Para reorganizar el orden de los formatos, toque o haga clic y arrastre los controladores.
Caracteres especiales configuring-special-characters
La opción para insertar caracteres especiales se puede activar o desactivar para el componente. Cuando se activa, se pueden definir los caracteres permitidos.
- Pulse o haga clic en el botón Añadir para insertar un carácter nuevo.
- Introduzca el código HTML del carácter y una descripción que se mostrarán en el cuadro de diálogo de edición.
- Para quitar un carácter, toque o haga clic en el botón Eliminar.
- Para reorganizar el orden de los caracteres, toque o haga clic y arrastre los controladores.
Pestaña Estilos styles-tab
El componente Texto es compatible con el sistema de estilos de AEM.
Capa de datos del cliente de Adobe data-layer
El componente Texto es compatible con la capa de datos del cliente de Adobe.