Nexus – Elemento: Number Range

image_pdfimage_print

¿Qué es?

Number Range es un componente de tipo Form. Muestra un control deslizante (slider) para seleccionar un valor numérico dentro de un rango definido. En el editor aparece identificado como “Range”. Al arrastrarlo al lienzo viene con un ejemplo precargado (etiqueta “Range”, valor 50 dentro de un rango de 0 a 100).

Propiedades

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

  • Component ID: identificador único del componente, autogenerado (ej. comp_fdbea1ec).
  • 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 control (ej. “Range”).
  • Default Value: valor numérico con el que arranca el slider al cargar la pantalla (ej. 50).
  • Min: valor mínimo del rango (ej. 0).
  • Max: valor máximo del rango (ej. 100).
  • Step: incremento entre cada valor posible al mover el slider (ej. 1).
  • Show current value: casilla (tildada por defecto) que muestra el valor numérico actual junto al slider.
  • Required: casilla que marca el campo como obligatorio.
  • Disabled: casilla que deshabilita el control, impidiendo que el usuario lo mueva.

Pestaña Style:

  • Sizing:
    • Width (columns): ancho del componente, medido en columnas (ej. 3).
    • 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 5 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 Number Range es seleccionar un presupuesto máximo en un filtro de búsqueda. Se cambia el Label por un texto como “Presupuesto máximo”, se ajustan Min y Max según el rango de precios disponible (por ejemplo, Min 0 y Max 5000), y se define un Step acorde (por ejemplo, 50) para que el usuario no tenga que ajustar valor por valor. El valor actual seleccionado puede luego usarse en otros componentes o acciones mediante su referencia ($comp.comp_fdbea1ec, copiable desde el panel Reference).