Vistas XML: Modals

Etiqueta modals

Los formularios modales son vistas complementarias a la vista principal, que permanecen ocultas hasta que son necesarias para la realización de una tarea específica. Estos formularios se declaran de manera muy similar a lo detallado en la sección columnas.

Para crear un formulario modal, debemos incluir una etiqueta group con un identificador name único. Dentro de este grupo podemos definir y personalizar las columnas que necesitemos, pero no se pueden crear nuevos grupos como se podía en la sección columnas.

Podemos declarar todos los formularios modales que necesitemos, declarando distintas etiquetas group dentro del grupo modals, y respetando la unicidad de sus identificadores. Para mostrar cualquiera de los formularios modales declarados, tendremos que definir un botón de tipo modal en la vista principal, en un row de tipo actions o footer, donde el atributo action del button sea igual al identificador del formulario modal. Más información sobre los botones de acción en Rows Actions.

Si no se indica el tamaño usado por la ventana modal será el estandar de bootstrap. Si se desea una ventana con un tamaño menor o mayor podemos incluir en la definición del grupo el atributo class:

modal-sm:Establece la ventana más pequeña que la estandar. modal-lg:Establece la ventana más grande que la estandar. modal-xl:Establece la ventana al mayor tamaño disponible.

El formulario modal mostrará la relación de columnas declaradas junto con unos botones de Aceptar y Cancelar para que el usuario pueda confirmar o cancelar el proceso a realizar.

Ejemplo:

<modals>
    <group name="test-lg" title="modal-title" class="modal-lg" icon="fas fa-files">
      <column name="name" numcolumns="12" description="desc-custommer-name">
          <widget type="text" fieldname="nombre" required="true" hint="desc-custommer-name-2" />
      </column>

      <column name="create-date" numcolumns="6">
          <widget type="date" fieldname="fechaalta" readonly="true" />
      </column>

      <column name="blocked-date" numcolumns="6">
          <widget type="date" fieldname="fechabaja" />
      </column>
    </group>

    <group name="test" title="other-data" icon="fas fa-users">
        <column name="name" numcolumns="12" description="desc-custommer-name">
            <widget type="text" fieldname="nombre" required="true" hint="desc-custommer-name-2" />
        </column>

        <column name="create-date" numcolumns="6">
            <widget type="date" fieldname="fechaalta" readonly="true" />
        </column>

        <column name="blocked-date" numcolumns="6">
            <widget type="date" fieldname="fechabaja" />
        </column>
    </group>
</modals>