Componente Casilla de verificación
Una casilla de verificación es un elemento gráfico de interfaz de usuario que se utiliza comúnmente en aplicaciones de software y formularios para permitir a los usuarios realizar una elección binaria entre dos opciones: activada (seleccionada) o desactivada (no seleccionada).
Una casilla de verificación suele representarse como un pequeño cuadrado que se puede activar o desactivar haciendo clic en ella o pulsándola. Cuando se marca una casilla de verificación, esta muestra una marca de verificación para indicar que la opción o función asociada está activa o habilitada.
NOTEEjemplo
Uso
Las razones más comunes para utilizar una casilla de verificación en un Formulario adaptable son las siguientes:
-
Facilidad de uso: las casillas de verificación son visualmente claras y proporcionan una forma directa de realizar elecciones binarias. Son intuitivas y fáciles de entender, por lo que son fáciles de usar.
-
Consentimiento y acuerdo: las casillas de verificación se utilizan para obtener el consentimiento del usuario para varios fines, por ejemplo, aceptar términos y condiciones, suscribirse a boletines informativos o confirmar la verificación de la edad. Dejan claro que el usuario está aceptando algo activamente.
-
Confirmación visual: las casillas de verificación marcadas proporcionan una confirmación visual a los usuarios de que su selección se ha registrado. Estos comentarios ayudan a evitar errores de usuarios y garantizan que sepan que sus opciones se han registrado.
-
Prevención de errores: las casillas de verificación reducen la probabilidad de que se produzcan errores al permitir que los usuarios revisen y confirmen las opciones antes del envío del formulario.
Versión y compatibilidad
El componente principal Casilla de verificación de formularios adaptables se publicó como parte de los componentes principales, versión 2.0.52. A continuación se muestra una tabla con todas las versiones compatibles, la compatibilidad con AEM y los vínculos a la documentación correspondiente:
| Versión del componente | AEM as a Cloud Service |
| — | — |
| Versión 1 | Compatible con la versión 2.0.52 y posteriores |
Para obtener información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.
Detalles técnicos
Obtenga la información más reciente sobre el Componente principal Casillas de verificación 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
Puede personalizar fácilmente la experiencia de las Casillas de verificación para los visitantes con el cuadro de diálogo de configuración. También puede definir las opciones de la Casilla de verificación con facilidad para que la experiencia del usuario sea óptima.
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.
-
Título: con este puede identificar fácilmente un componente en un formulario y, de forma predeterminada, el título aparece sobre el componente. Si no agrega un título, el componente no se muestra.
-
Permitir texto enriquecido en el título: esta función permite a los usuarios dar formato a los títulos de texto sin formato, incorporando funciones como negrita, cursiva, texto subrayado, varias fuentes, tamaños de fuente, colores y opciones adicionales para mejorar la presentación visual y la personalización. Ofrece una mayor flexibilidad y control creativo para hacer que los títulos destaquen dentro de los documentos, sitios web o aplicaciones.
Al seleccionar la casilla de verificación de Permitir texto enriquecido en el título, las opciones de formato se vuelven visibles para aplicar estilo al título del componente. Para acceder a todas las opciones de formato disponibles, puede hacer clic en la pestaña
-
Ocultar título: seleccione la opción para ocultar el título del componente.
-
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 orígenes de datos externos, 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.
-
Tipo de datos del valor enviado: esta opción especifica el tipo de datos del valor enviado cuando se selecciona cualquier opción. Si el tipo de datos del valor enviado está establecido en
Numbery se agregan datos de cadena a Valor de datos en la pestaña Opciones, la pantalla muestra un mensaje de errorValue type mismatch. -
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.
-
Deshabilitar componente: seleccione la opción para desactivar o bloquear el componente. El componente desactivado no está activo ni puede editarlo el usuario final. El usuario puede ver el valor del campo, pero no modificarlo. El componente permanece accesible para otros fines, como utilizarlo para los cálculos en el Editor de reglas.
-
Cuando se selecciona, se devuelve el valor: seleccione esta opción para especificar qué valor debe asociarse a la casilla de verificación cuando está activada o seleccionada. Es la acción que se produce cuando un usuario marca o usted marca la casilla de verificación.
-
Conservar valor del estado Desmarcar: al seleccionar esta opción, puede especificar el valor que se devolverá cuando el componente de la casilla de verificación no esté seleccionado. Si Conservar valor de estado de desactivación está activada o configurada como verdadera, aparece la opción Cuando no está marcada, devuelve un valor.
-
Cuando no está marcada, devuelve un valor: la opción le permite especificar qué valor debe asociarse con la casilla de verificación cuando está en un estado sin marcar o sin seleccionar.
-
Valor predeterminado: esta opción permite añadir un valor predeterminado en un campo de formulario. Si se selecciona Deshabilitar componente, aparece en pantalla el valor predeterminado. Si el usuario no introduce ningún valor en el campo del formulario, este valor se envía en el momento del envío del formulario.
Pestaña Validación
-
Obligatorio: seleccione esta opción si desea mostrar el componente en un formulario adaptable. Después de seleccionar la opción, debe realizar una selección antes de continuar con el envío de un formulario. No puede seleccionar Ocultar componente o Deshabilitar componente en la pestaña Básico cuando se selecciona esta opción.
-
Mensaje de error: esta opción permite introducir un mensaje que se muestra si se marca la casilla Obligatorio y el campo del formulario se deja en blanco.
-
Mensaje de validación de secuencia de comandos: esta opción le permite introducir un mensaje que se mostrará si la validación de la secuencia de comandos falla.
Pestaña Contenido de ayuda
-
Descripción breve: una descripción breve es una explicación de texto corta que proporciona información adicional o aclaraciones acerca del propósito de un campo de formulario específico. Ayuda al usuario a comprender qué tipo de datos se deben escribir en el campo y puede proporcionar directrices o ejemplos para garantizar que la información introducida sea válida y cumpla los criterios deseados. De forma predeterminada, las descripciones cortas permanecen ocultas. Active la opción Mostrar siempre una descripción breve para mostrarla debajo del componente.
-
Mostrar siempre una descripción breve: active la opción para mostrar la descripción breve debajo del componente.
-
Texto de ayuda: el texto de ayuda hace referencia a información o directrices adicionales que se proporcionan para ayudar a rellenar correctamente un campo de formulario. Aparece cuando el usuario hace clic en el icono de ayuda (i) situado junto al componente. El texto de ayuda proporciona información más detallada que la etiqueta de un campo de formulario o el texto del marcador de posición, y está diseñado para ayudar al usuario a comprender los requisitos o restricciones del campo. También puede ofrecer sugerencias o ejemplos para que el formulario sea más fácil y preciso.
