Nexus – Elemento: Date

image_pdfimage_print

¿Qué es?

Date es un componente de tipo Form. Muestra un selector de fecha, con calendario desplegable, para que el usuario elija un día. Al arrastrarlo al lienzo viene con un ejemplo precargado (etiqueta “Date”, sin fecha seleccionada, mostrando el formato “dd/mm/aaaa”).

Propiedades

Al seleccionar Date en el lienzo, el panel derecho muestra “Properties of Date”, organizado en tres pestañas: Content, Style y Behavior.

  • Component ID: identificador único del componente, autogenerado (ej. comp_c93cbe80).
  • 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:

  • Label: texto de la etiqueta del campo (ej. “Date”).
  • Min Date: fecha mínima seleccionable. Tiene un selector de fecha (dd/mm/aaaa) y, debajo, un campo de texto alternativo con placeholder “YYYY-MM-DD o {{ binding }}”, para escribir una fecha fija en ese formato o una expresión de binding dinámica.
  • Max Date: fecha máxima seleccionable, con la misma estructura que Min Date.
  • Default Value: fecha con la que arranca el campo al cargar la pantalla, con la misma estructura que Min Date.
  • Required: casilla que marca el campo como obligatorio.
  • Disabled: casilla que deshabilita el campo, impidiendo que el usuario lo edite.

El calendario desplegable que se abre al hacer clic en cualquiera de estos selectores de fecha se muestra en español, con el mes y año navegables mediante flechas, y dos accesos rápidos: Borrar (vacía la fecha seleccionada) y Hoy (selecciona la fecha actual).

Pestaña Style:

  • Sizing:
    • Width (columns): ancho del componente, medido en columnas (ej. 4).
    • Height (rows): alto del componente, medido en filas (ej. 2).
    • Nota del propio panel: la pantalla es una grilla de 12 columnas; el ancho no puede superar las 4 columnas en esa posición, y el alto puede crecer libremente ya que la pantalla tiene scroll.
  • Custom Class: clase CSS personalizada.
  • Custom Style: CSS personalizado aplicado directamente a este componente.

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 Date es un campo de “Fecha de nacimiento” o “Fecha de turno”. Se cambia el Label según corresponda, y se pueden limitar las fechas seleccionables con Min Date y Max Date. Por ejemplo, para que solo se puedan elegir fechas futuras a partir de hoy, en Min Date se puede escribir una expresión de binding en vez de una fecha fija (como una referencia a la fecha actual, si el proyecto cuenta con una variable o función para eso), en lugar de escribir manualmente una fecha. El valor seleccionado puede luego usarse en otros componentes o acciones mediante su referencia ($comp.comp_c93cbe80, copiable desde el panel Reference).