DocumentaciónAEMGuía de componentes principales

Componente Texto text-adaptive-forms-core-component

Last update: Fri Nov 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador
  • Administrador
  • Usuario

En un formulario adaptable, el texto hace referencia al contenido que se muestra en el formulario para que el usuario lo lea. Esto puede incluir el texto que se utiliza para etiquetar un grupo de elementos de formulario, como los campos de texto, así como cualquier instrucción o información adicional que se proporcione al usuario.

Esto también puede ayudar a dividir la estructura de un formulario en secciones lógicas, facilitando a los usuarios la comprensión y la cumplimentación del formulario. Además, podría utilizarse con fines de accesibilidad para proporcionar una breve descripción del elemento al que está asociado. Este campo de texto suele mostrarse cerca de los componentes del formulario, como antes o después de él.

Ejemplo

ejemplo de texto

Uso reasons-to-use-text-label

Hay varias razones para utilizar texto en un formulario:

  • Proporcionar instrucciones: se puede utilizar el texto para proporcionar instrucciones sobre cómo rellenar el formulario o qué información se necesita.

  • Proporcionar contexto: el texto se puede utilizar para proporcionar contexto al formulario, como explicar la finalidad del formulario o la organización que recopila la información.

  • Dividir el formulario en secciones lógicas: el texto se puede utilizar para dividir un formulario en secciones lógicas, facilitando a los usuarios su comprensión y cumplimentación.

  • Personalización de marca e identidad: el texto se puede utilizar para la personalización de la marca y la identidad, como incluir el nombre de la organización en el formulario.

Versión y compatibilidad version-and-compatibility

El componente principal Texto de Forms adaptable se publicó en febrero de 2023 como parte de los componentes principales 2.0.4 para Cloud Service AEM y los componentes principales 1.1.12 para Forms 6.5.16.0 de o posterior. A continuación se muestra una tabla con todas las versiones admitidas, la compatibilidad con AEM y los vínculos a la documentación correspondiente:

Versión del componente
AEM as a Cloud Service
AEM 6.5.16.0 Forms o posteriores
Versión 1
Compatible con la
versión 2.0.4 y posteriores
Compatible con la
versión 1.1.12 y posteriores, pero inferiores a 2.0.0.

Para obtener información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.

Detalles técnicos technical-details

Obtenga la información más reciente sobre el componente principal de texto de formularios adaptables en la documentación técnica de GitHub. Para obtener más información sobre el desarrollo de los componentes principales, consulte la Documentación para desarrolladores de componentes principales.

Cuadro de diálogo de configuración configure-dialog

Puede personalizar fácilmente la experiencia de texto para los visitantes con el cuadro de diálogo de configuración. También puede definir opciones de texto con facilidad para que la experiencia del usuario sea óptima.

Pestaña Básico

Pestaña Básicos

  • Nombre: puede identificar fácilmente un componente de formulario con su nombre único tanto en el formulario como en el editor de reglas, pero el nombre no debe contener espacios ni caracteres especiales.

  • Referencia de vínculo: una referencia de vínculo es una referencia a un elemento de datos que se almacena en una fuente de datos externa y se utiliza en un formulario. La referencia de enlace permite enlazar datos de forma dinámica a campos de formulario, de modo que el formulario pueda mostrar los datos más actualizados de la fuente de datos. Por ejemplo, se puede utilizar una referencia de enlace para mostrar el nombre y la dirección de un cliente en un formulario, según el ID introducido en el formulario por el cliente. La referencia de enlace también se puede utilizar para actualizar la fuente de datos con los datos del formulario. De este modo, AEM Forms permite crear formularios que interactúen con fuentes de datos externas, lo que proporciona al usuario una experiencia óptima para recopilar y administrar datos.

  • Marcar como elemento de formulario independiente: seleccione la opción para configurar un campo de formulario no vinculado a ningún esquema. Esta opción le permite guardar datos sin actualizar la fuente de datos. También le permite gestionar los datos de forma personalizada, independientemente de la integración de bases de datos estándar.

  • Ocultar componente: seleccione la opción para ocultar el componente del formulario. El componente permanece accesible para otros fines, como utilizarlo para los cálculos en el Editor de reglas. Esto resulta útil cuando necesita almacenar información que el usuario no necesita ver o cambiar directamente.

Cuadro de diálogo Diseño design-dialog

El cuadro de diálogo Diseño se utiliza para definir y administrar estilos CSS para el componente Texto.

Pestaña Estilos styles-tab

La pestaña se utiliza para definir y administrar estilos CSS de un componente. El componente principal de texto de formularios adaptables es compatible con el sistema de estilos de AEM.

Cuadro de diálogo de diseño

  • Clases CSS predeterminadas: puede proporcionar una clase CSS predeterminada para el componente principal de texto de formularios adaptables.

  • Estilos permitidos: puede definir estilos proporcionando un nombre y la clase de CSS que representa el estilo. Por ejemplo, puede crear un estilo llamado “texto en negrita” y proporcionar la clase de CSS “grosor de fuente: negrita”. Puede utilizar o aplicar estos estilos a un formulario adaptable en el editor de formularios adaptable. Para aplicar un estilo, en el editor de Formularios adaptables, seleccione el componente al que desee aplicar el estilo, vaya al cuadro de diálogo de propiedades y seleccione el estilo que desee en la lista desplegable Estilos. Si necesita actualizar o modificar los estilos, simplemente vuelva al cuadro de diálogo Diseño, actualice los estilos en la pestaña Estilos y guarde los cambios.

Propiedades personalizadas

Cuadro de diálogo Propiedades personalizadas

Las propiedades personalizadas le permiten asociar atributos personalizados (pares clave-valor) a un componente principal del formulario adaptable mediante la plantilla de un formulario. Las propiedades personalizadas se reflejan en la sección de propiedades de la representación sin encabezado del componente. Permite crear un comportamiento de formulario dinámico que se adapta en función de los valores de atributos personalizados. Por ejemplo, los desarrolladores pueden diseñar varias representaciones de un componente Forms sin encabezado para plataformas móviles, de escritorio o web, lo que mejora significativamente la experiencia del usuario en una amplia gama de dispositivos.

  • Nombre de grupo: puede proporcionar un nombre para identificar el grupo de propiedades personalizadas. Puede agregar, eliminar o reorganizar varios grupos de propiedades personalizadas. Después de añadir el grupo de propiedades personalizadas, podrá ver las siguientes opciones:

    • Pares de clave-valor: puede agregar varios nombres de propiedades personalizadas y valores de propiedades personalizadas haciendo clic en el botón Añadir para cada grupo de propiedades personalizadas.

    • Eliminar: toque o haga clic para eliminar el nombre de la propiedad personalizada y el valor de la propiedad personalizada.

    • Reorganizar: toque o haga clic y arrastre para reorganizar el orden del nombre de la propiedad personalizada y el valor de la propiedad personalizada.

Consulte también see-also

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c