Componente Opciones de formulario (versión 1)

El componente principal Opciones de formulario permite seleccionar entre las opciones predefinidas en distintos formatos.

Uso

El componente principal Opciones de formulario permite enviar diferentes tipos de opciones presentadas de diferentes maneras y está diseñado para utilizarse junto con el componente Contenedor de formulario.

El editor de contenido puede definir la presentación de las opciones, etiquetas y opciones individuales en el cuadro de diálogo de configuración.

Versión y compatibilidad

Este documento describe la versión 1 del componente Opciones de formulario, introducido originalmente con la versión 1.0.0 de los componentes principales con AEM 6.3.

En la tabla siguiente se muestra la compatibilidad de la versión 1 del componente Opciones de formulario.

Salida del componente de ejemplo

El siguiente es un ejemplo tomado de We.Retail.

Captura de pantalla

HTML

<div class="cmp cmp-form aem-GridColumn aem-GridColumn--default--12">
<form method="POST" action="/content/we-retail/us/en/experience.html" id="new_form" name="new_form" enctype="multipart/form-data" class="aem-Grid aem-Grid--12 aem-Grid--default--12 ">
    <input type="hidden" name=":formstart" value="/content/we-retail/us/en/experience/jcr:content/root/responsivegrid/container">
    
    <div class="cmp cmp-options aem-GridColumn aem-GridColumn--default--12">

    <fieldset class="form-group checkbox">
        <legend>What is your favorite type of toast?</legend>
        
        <div class="checkbox-item">
            <label>
              <input type="checkbox" name="toasttypes" value="dry">
              Plain dry toast
            </label>
        </div>
<div class="checkbox-item">
            <label>
              <input type="checkbox" name="toasttypes" value="french">
              French toast
            </label>
        </div>
<div class="checkbox-item">
            <label>
              <input type="checkbox" name="toasttypes" value="texas">
              Texas toast
            </label>
        </div>

    </fieldset>
    
</div>
    
</form></div>

JSON

"container": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              "columnCount": 12,
              "gridClassNames": "aem-Grid aem-Grid--12 aem-Grid--default--12",
              ":items": {
                "options": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/options",
                  "name": "toastTypes",
                  "jcr:title": "What is your favorite type of toast?",
                  "source": "local",
                  "type": "checkbox"
                }
              },
              ":itemsOrder": [
                "options"
              ],
              ":type": "weretail/components/form/container"
            }

Cuadro de diálogo de configuración

El cuadro de diálogo de configuración permite al autor del contenido definir el tipo de opciones que se deben presentar, las etiquetas y las opciones disponibles.

• Tipos
  Presentación de las opciones

  • Casillas de verificación
  • Botones de radio
  • Lista desplegable
  • Lista desplegable de selección múltiple

• Título: el título que se mostrará como etiqueta para las opciones

• Nombre: el nombre del campo, que se envía con los datos del formulario

• Origen: donde se definen las opciones

  • Local: se define dentro del componente
    • Pulse o haga clic en el botón Añadir para añadir un valor y en Eliminar para eliminarlo
    • Valor: el valor guardado cuando se selecciona esa opción cuando se envía el formulario
    • Texto: etiqueta de la opción que se muestra en el formulario.
    • Activo: la opción se marca como seleccionada cuando se carga el formulario
    • Desactivado: la opción no se puede seleccionar pero se sigue mostrando
    • Lista: se utiliza una lista estática definida en otra parte de AEM para la opción
      • Lista: la ruta de la lista estática de AEM
        • Utilice el botón Examinar para localizar el recurso de la lista
    • Fuente de datos: se utiliza una fuente de datos para las opciones
      • Fuente de datos: tipo de recurso de la fuente de datos

• Mensaje de ayuda: una sugerencia al usuario sobre lo que se puede introducir en el campo

Cuadro de diálogo de diseño

No hay ningún cuadro de diálogo de diseño para el componente Opciones de formulario.

Detalles técnicos

La documentación técnica más reciente sobre el componente Opciones de formulario se encuentra en GitHub.

Todo el proyecto de componentes principales se puede descargar desde GitHub.

Puede encontrar más información sobre el desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.