Calendar
El Calendar le da al usuario una forma clara y visual de elegir una fecha puntual o un intervalo de fechas, dentro de flujos donde el contexto temporal es decisivo: reservas, filtros por día, reportes o planificación.
Previsualización rápida
Section titled “Previsualización rápida”Fecha simple
Section titled “Fecha simple”| domingo | lunes | martes | miércoles | jueves | viernes | sábado |
|---|
Rango de fechas
Section titled “Rango de fechas”| domingo | lunes | martes | miércoles | jueves | viernes | sábado |
|---|
Desplegado desde un trigger
Section titled “Desplegado desde un trigger”En desktop el panel se abre por debajo del botón; en mobile se abre como drawer inferior.
| domingo | lunes | martes | miércoles | jueves | viernes | sábado |
|---|
Propósito
Section titled “Propósito”Selección de fechas. El Calendar ofrece una interfaz clara para elegir fechas en momentos del flujo donde el tiempo importa.
El recorrido esperado del usuario es:
- Abre el calendario desde su trigger (normalmente un DateInput o un botón con ícono de calendario).
- Selecciona la fecha o el rango que necesita.
- Sale del calendario haciendo click fuera del panel o sobre el mismo botón que lo disparó.
- La selección queda visible de inmediato en el trigger o en el drawer.
- Para que la selección tenga efecto, el usuario debe aplicar los cambios a nivel general (por ejemplo, con el botón “Aplicar” del panel de filtros). Elegir una fecha no ejecuta la acción por sí sola.
Relación con otros componentes
Section titled “Relación con otros componentes”- DateInput: usa internamente el Calendar para desplegar el panel de selección.
- RangeCalendar: variante del Calendar para seleccionar intervalos de fechas.
- MonthPicker / YearPicker: para selecciones más amplias, por mes o por año. Siguen la misma lógica de selección simple o por rango.
La lógica de interacción (fecha simple o rango de días, meses o años) se alinea con el comportamiento de referencia del DatePicker de Mantine.
Anatomía del componente
Section titled “Anatomía del componente”- Trigger: botón o DateInput que abre el calendario. Muestra el ícono de calendario y, una vez elegida, la fecha o el rango seleccionado.
- Panel contenedor: superficie flotante con borde, radio y sombra que agrupa todo el calendario. En mobile se convierte en drawer con un tirador superior.
- Navegación de mes: flechas de mes anterior y mes siguiente.
- Título de contexto: mes y año visibles (por ejemplo, “Enero 2022”). Se anuncia a lectores de pantalla cada vez que cambia.
- Encabezado de días: abreviaturas de los días de la semana (Do, Lu, Ma, Mi, Ju, Vi, Sa).
- Grilla de días: seis semanas fijas, para que la altura del panel no salte al cambiar de mes.
- Día del mes: celda seleccionable con el número del día.
- Días fuera del mes: días del mes anterior y siguiente, atenuados y no seleccionables.
- Indicador de hoy: anillo de color primario sobre la fecha actual.
- Selección: círculo relleno en color primario sobre la fecha elegida o sobre los extremos del rango.
- Banda de rango: fondo suave que une la fecha de inicio con la fecha de fin.
Estados de interacción
Section titled “Estados de interacción”| Estado | Comportamiento visual | Pauta de uso |
|---|---|---|
| Default | Número en color de texto principal sobre fondo neutro. | Estado base de cualquier día disponible. |
| Hover | Círculo de fondo primario suave. | Indica que el día es clickeable. En modo rango, además previsualiza la banda hasta el día bajo el cursor. |
| Focus | Contorno primario visible alrededor del día. | Aparece al navegar con teclado; nunca debe ocultarse. |
| Active | Círculo primario más intenso mientras se presiona. | Confirma el gesto de selección. |
| Hoy | Anillo primario y número en semibold. | Sirve de referencia temporal; no implica selección. |
| Seleccionado | Círculo primario relleno con número en blanco. | Fecha elegida en modo simple, o inicio y fin en modo rango. |
| En rango | Banda de fondo primario suave entre inicio y fin. | Comunica la continuidad del intervalo. |
| Previsualización de rango | Banda suave y borde punteado en el posible día final. | Se muestra tras elegir el inicio, antes de confirmar el fin. |
| Disabled | Número gris y tachado; cursor no permitido. | Fechas fuera del mínimo o máximo permitido, o excluidas por negocio. |
| Fuera del mes | Número gris, sin interacción. | Solo dan contexto de la semana; no son seleccionables. |
| domingo | lunes | martes | miércoles | jueves | viernes | sábado |
|---|
Usos recomendados y guía de UX
Section titled “Usos recomendados y guía de UX”Cuándo usar
Section titled “Cuándo usar”- Cuando el usuario necesita elegir una fecha específica o un rango de fechas.
- En filtros temporales, por ejemplo “del 1 al 15 de mayo”.
- En combinación con DatePicker o DateInput para mostrar el calendario emergente.
- En reservas, agendas y reportes donde ver la semana completa ayuda a decidir.
Cuándo NO usar
Section titled “Cuándo NO usar”- Solo hay que mostrar una fecha: usar texto formateado; un calendario sugiere que se puede editar.
- Se necesita ingresar fechas manualmente, como una fecha de nacimiento lejana: usar DateInput, que permite tipear.
- La granularidad es mayor que un día: usar MonthPicker o YearPicker en lugar de forzar al usuario a navegar mes a mes.
- Aplicar el filtro al primer click: evitarlo. La selección se confirma a nivel general, no en cada toque.
Buenas prácticas
Section titled “Buenas prácticas”- Indicar siempre qué fechas no están disponibles con el estado deshabilitado, en lugar de ocultarlas.
- En rangos, mostrar la previsualización para que el usuario entienda el intervalo antes de confirmarlo.
- Si el usuario elige primero una fecha de fin anterior a la de inicio, el componente invierte el orden automáticamente; no mostrar errores por eso.
- Mantener visible la selección en el trigger tras cerrar el calendario, para que el usuario no dependa de su memoria.
Variantes / Opciones
Section titled “Variantes / Opciones”Tipo de selección
Section titled “Tipo de selección”- Simple: un único día. Un nuevo click reemplaza la selección anterior.
- Rango: el primer click marca la fecha de inicio y el segundo la fecha de fin. Un tercer click reinicia el rango desde esa fecha.
Modo de visualización
Section titled “Modo de visualización”- Inline: el calendario está siempre visible dentro de la página. Útil en paneles laterales, agendas o pantallas donde la fecha es el protagonista.
- Popover: el calendario se despliega desde un trigger y se cierra al hacer click fuera, al volver a pulsar el trigger o con la tecla Escape.
Posición y distancia
Section titled “Posición y distancia”- Se despliega como menú flotante en una capa superior (z-index de dropdown).
- Por defecto se abre debajo del trigger, alineado a su borde izquierdo.
- Si no hay espacio suficiente, se reacomoda automáticamente por encima o alineado a la derecha.
- La distancia entre el trigger y el panel es siempre de 8px.
Dispositivo
Section titled “Dispositivo”- Desktop: el calendario se abre flotando bajo el trigger.
- Mobile: el calendario se abre desde un drawer inferior a todo el ancho, con un tirador superior y fondo oscurecido detrás. Las celdas se expanden para ofrecer áreas táctiles más cómodas.
Opciones de configuración
Section titled “Opciones de configuración”- Fecha mínima y máxima: acotan el período seleccionable.
- Fechas excluidas: bloquean días puntuales, como feriados o días sin disponibilidad.
- Días fuera del mes: se pueden mostrar atenuados (opción por defecto) u ocultar.
- Primer día de la semana: domingo por defecto, o lunes según la región.
- Deshabilitado: bloquea por completo el componente y su trigger.
| lunes | martes | miércoles | jueves | viernes | sábado | domingo |
|---|
Accesibilidad
Section titled “Accesibilidad”El componente sigue las recomendaciones del WAI-ARIA Authoring Practices para grillas de calendario.
Semántica
Section titled “Semántica”- El calendario completo se presenta como una grilla; cada semana es una fila y cada día una celda.
- Los encabezados de los días (Lu, Ma, etc.) son encabezados de columna y anuncian el nombre completo del día.
- Los controles de mes y año son botones.
- La fecha seleccionada se marca como seleccionada y las no disponibles como deshabilitadas.
- Así, los lectores de pantalla interpretan la estructura como una tabla interactiva de días.
Navegación por teclado
Section titled “Navegación por teclado”| Tecla | Acción |
|---|---|
| Flecha izquierda / derecha | Mueve el foco un día. |
| Flecha arriba / abajo | Mueve el foco una semana. |
| Home / End | Va al primer o último día de la semana. |
| Page Up / Page Down | Cambia de mes. |
| Shift + Page Up / Page Down | Cambia de año. |
| Enter o Espacio | Selecciona la fecha enfocada. |
| Tab | Alterna entre los botones del header y la grilla de fechas. |
| Escape | Cierra el calendario y devuelve el foco al trigger (modo popover). |
Lector de pantalla
Section titled “Lector de pantalla”- Cada día anuncia su día de la semana, número, mes y año completos.
- Al cambiar de mes o de año se anuncia el nuevo contexto, por ejemplo “Octubre 2025”.
- En modo rango se informa “fecha de inicio” y “fecha de fin” según corresponda.
- Los días fuera del mes no son seleccionables y se anuncian como deshabilitados.
ChangeLog
Section titled “ChangeLog”El historial de cambios de todos los componentes de Monkey se registra en la Sheet de ChangeLog.