Nexus – Elemento: Modal

¿Qué es?
Modal es un componente de tipo Layout. Representa una ventana emergente (modal/pop up) que se superpone a la pantalla, usada típicamente para formularios, confirmaciones o contenido adicional sin salir de la pantalla actual. A diferencia de los demás componentes, un Modal no se “dibuja” directamente sobre el lienzo: el lienzo muestra un aviso “Modals are not shown on the canvas. Click to see them in the Modals list” y un indicador “1 modal on this screen” arriba a la derecha.

Dónde se edita
Los modales de una pantalla se administran desde un panel lateral colapsable llamado Modals (N), ubicado al lado de “Components on canvas”. Ahí se lista cada modal con su título (ej. “Modal (Modal title)”), y al pasar el mouse sobre la fila aparecen íconos de acciones rápidas, entre ellos uno para duplicarlo y otro (ícono de rayo) que al dejar el mouse encima muestra el tooltip “Copy reference: {{ $comp.comp_c2d8acd2 }}”, para copiar la referencia del modal sin tener que abrir el panel Reference.




Propiedades
Al seleccionar un Modal (haciendo clic en su fila dentro del panel Modals), el panel derecho muestra “Properties of Modal”, organizado en tres pestañas: Content, Style y Behavior.
- Component ID: identificador único del componente, autogenerado (ej.
comp_c2d8acd2). - Visibility → Hidden on load: casilla para que el componente esté oculto al cargar la pantalla. Puede mostrarse luego mediante una acción de tipo Show.
- Selector S / M / L: ajusta el tamaño de visualización del panel de propiedades.
Pestaña Content:
- Title: título que se muestra en la cabecera del modal (ej. “Modal title”).
- Footer component IDs (comma-separated): lista de Component IDs, separados por coma, de los componentes que se quieren mostrar en el pie del modal (por ejemplo, botones de “Cancelar” y “Guardar”).
- Open (binding/action controlled): casilla que indica que el modal se abre únicamente mediante una expresión de binding o una acción (por ejemplo, desde un botón con Events & Actions), no por sí solo.
- Width: menú desplegable con el ancho del modal (ej. “Medium”).
- Show close button: casilla (tildada por defecto) que muestra u oculta el botón de cerrar (X) en la cabecera del modal.
- Close on overlay click: casilla (tildada por defecto) que define si el modal se cierra al hacer clic fuera de él (sobre el fondo oscurecido).

Pestaña Style:
- Custom Class: clase CSS personalizada.
- Custom Style: CSS personalizado aplicado directamente a este componente.
(A diferencia de otros componentes, Modal no tiene sección Sizing en Style, ya que no ocupa un espacio fijo dentro de la grilla de la pantalla.)

Pestaña Behavior:
- Events & Actions: sistema para definir comportamientos interactivos. Ver documentación aparte: Nexus – Events & Actions .
- Delete Component (ícono de papelera, arriba): elimina el componente del lienzo.

Ejemplo de uso
Un uso típico de Modal es un formulario de “Agregar nuevo cliente” que se abre al presionar un botón. Se arma el contenido del formulario dentro del modal, se tilda Open (binding/action controlled), y en el botón que lo dispara se agrega una acción (Events & Actions) que haga referencia al modal para abrirlo. En Footer component IDs se pueden poner los IDs de dos botones (“Cancelar” y “Guardar”), para que queden fijos en la parte inferior del modal en vez de mezclarse con el contenido que pueda tener scroll.