Skip to main content

Period Picker

El Period Picker es un componente de selección de periodos de tiempo que permite al usuario elegir intervalos específicos, como mes, quincena o semana. Este selector es ideal para aplicaciones que manejan información periódica, como reportes de nómina o métricas de rendimiento, ya que permite al usuario segmentar y analizar datos de acuerdo a sus necesidades temporales de forma rápida y precisa.

Playground

<%= f.label :start_period, "Period Picker" %>
<%= period_date_picker f,
:start_period,
default_month: '01-01-2024'.to_date,
period_type: :monthly %>

Lista de parámetros

Todos los named params son opcionales.

ParámetroTipoTipo de datoDetalle
formPositional ParamForm de Simple FormFormulario dentro del cual se encuentra el input.
namePositional ParamStringNombre que tendrá el input. Internamente se añade el namespace completo en base a la anidación del formulario en que se encuentra.
idNamed ParamStringID del input. Si no se ingresa, se usa el name. Al igual que el name, automáticamente se añade el namespace.
placeholderNamed ParamStringTexto que se muestra en el input cuando no tiene valor.
period_typeNamed ParamSymbolTipo de periodo a seleccionar. Puede ser :monthly, :semi_monthly o :weekly.
requiredNamed ParamBooleanIndica si el campo es requerido o no.
valueNamed ParamDateValor inicial del input.
disabledNamed ParamBooleanIndica si el campo está deshabilitado o no.
read_onlyNamed ParamBooleanIndica si el campo es de solo lectura
hintNamed ParamStringTexto de ayuda que se muestra debajo del input
error_messageNamed ParamStringMensaje de error que se muestra debajo del input
default_monthNamed ParamDateMes por defecto en que se desplegará el calendario. Solo utilizado si es que no hay valor por defecto.
start_dateNamed ParamDateFecha mínima que se puede seleccionar.
end_dateNamed ParamDateFecha máxima que se puede seleccionar.
link_start_dateNamed ParamString (Query Selector)Query selector (#start_period por ejemplo) de un period picker que será el inicio de un rango (desde). Este se ingresa en el selector del fin de este rango (hasta). Con esta configuración, el selector "hasta" no podrá seleccionar fechas anteriores a la seleccionada en el selector "desde".
intercoolerNamed ParamHashHash con opciones para intercooler. (Todos los parámetros del tipo ic-*).
dataNamed ParamHashHash con los parámetros del tipo data-*.
**optsNamed Param {}HashTodos los parámetros extra que se quieran pasar al input y no estén mencionados arriba.

Anatomía

alt-text
message

Hola 👋

Evalúa tu experiencia utilizando nuestro Design System

Déjanos un comentario