Calendar

Preview

About

Standalone calendar grid (month view or year grid) for picking a date or a range. It's the internal building block behind KasyDatePicker — it can also be used on its own, inside a popover, card, or bottom sheet.

• value / onChanged: single selected date (single mode, default).
• range / onRangeChanged: start/end range (selectionMode: KasyDateSelectionMode.range).
• selectionMode: single or range.
• initialView: opens on the day grid (month, default) or the year list (year).
• minDate / maxDate: limits selectable dates.
• monthsToShow: how many months side by side (1 to 3) for ranges on wide screens.
• locale: month names, weekday abbreviations, and start of week (KasyDatePickerLocale.en/es/pt).
• markedDates: days with a small indicator dot below the number (e.g. events).
• topContent / bottomContent: slots for extra content above/below the grid.
• showTime / time / onTimeChanged / timeZoneLabel / timeInvalid: optional time row below the grid.
• showDragHandle: shows a drag handle at the top (for bottom sheet use).
• showCard: wraps in a rounded surface with shadow (default true); set to false when the parent already provides the surface.
• width: fixed width for the card.

Last updated on 08/23/2026