S
M
T
W
T
F
S
Selected
Monday, May 11, 2026
Installation
npx shadcn@latest add @iconiq/calendarProps
Calendar
7 props
Animated monthly calendar card that now supports both controlled and uncontrolled month and selection state.
selected
DateControlled selected day. When provided, the highlighted day is always derived from this prop.
defaultSelected
DateInitial selected day for uncontrolled usage when selected is not provided.
onSelect
(date: Date) => voidCalled when the user picks an interactive day in the current month.
month
DateControlled visible month. Prev/next navigation requests flow through onMonthChange.
defaultMonth
DateInitial visible month for uncontrolled usage when month is not provided.
onMonthChange
(month: Date) => voidCalled whenever the user navigates to a previous or next month.
disabled
(date: Date) => booleanMarks dates as non-interactive. Disabled days keep the same visuals but cannot be selected.
Notes
Controlled mode: pass selected/month and respond to onSelect/onMonthChange.
Uncontrolled mode: omit selected/month and optionally seed with defaultSelected/defaultMonth.
When no defaults are provided, selected date and visible month both start from new Date().