Calendar
newThirty days hath September, and this grid knows all of them. A month to pick a date from.
Tuesday, October 6, 2026
Open Props in the corner of the example to try color, size and disabled.
size runs xs to xl on the control scale, md by default. A day is as tall as a control of the same size: 28px at xs, 36px at md, 48px at xl. The arrows are icon buttons of the same size, so the header lines up with the grid.
color tints the selected day and today's outline. neutral is the monochrome one. Your own colours work as on Button.
Installation
Usage
<script setup lang="ts">
import { CalendarDate } from '@internationalized/date'
import type { DateValue } from 'reka-ui'
import { Calendar } from '@/components/ui/calendar'
const date = shallowRef<DateValue | undefined>(new CalendarDate(2026, 10, 6))
</script>
<template>
<Calendar v-model="date" />
</template>
v-model is a date from @internationalized/date, CalendarDate for a plain day, or undefined when nothing is picked. Clicking the selected day again clears it; prevent-deselect stops that. Type your ref as DateValue, the type the events carry, not as CalendarDate.
Keep one copy of @internationalized/date in your app. The install adds it; two copies end in '#private' refers to a different member type errors.
The heading sits at the start and the arrows at the end, Material 3 style. The grid always draws six weeks, so the calendar keeps its height from month to month and a popover around it doesn't jump. Set :fixed-weeks="false" to draw only the weeks a month needs.
The calendar has no hidden input, so it doesn't submit with a plain <form>. Bind v-model to your form library instead, as in the form example. Inside a Field it takes the field's disabled and invalid state, and the field label names it together with the month.
Need a start and an end date? That's Range Calendar.
Examples
Multiple
With multiple, each click toggles a day and v-model is an array.
Pick your on-call days
Click a day again to hand it back.
- Fri, Oct 9
- Sat, Oct 10
Min and max
Days before min-value and after max-value are disabled, and the arrows stop at their months. The arrow keys stop there too.
Bookings open up to 60 days ahead.
Disabled dates
is-date-disabled takes a function that returns true for days that can't be picked. Disabled days fade and the arrow keys skip them.
Unavailable dates
is-date-unavailable is for days that exist but are taken. They're struck through and can't be picked, but keyboard focus still lands on them, so a screen reader user hears they're there.
Fully booked
Week numbers
week-numbers adds a column of week numbers. Each one is counted from the first day of its row, so the column stays right when week-starts-on differs from the locale's start. de-DE counts ISO weeks.
week-starts-on runs from 0, Sunday, to 6. Leave it out and the locale decides: Sunday for en-US, Monday for de-DE.
Locale
Month names, weekdays and digits follow locale or Reka UI's ConfigProvider, and so does the direction: in right-to-left the arrows flip and so do the arrow keys. For a non-Gregorian calendar, pass a date in it, here with toCalendar(date, new PersianCalendar()).
Month and year select
The heading slot gets { headingValue, date, setPlaceholder }. setPlaceholder moves the view to a date's month without selecting anything, so two Selects make a quick way back to 1990. Build the year list from your bounds, not from the month on screen, or it drifts as you page.
May 17, 1990
Placeholder
The placeholder is the month on screen. Bind it with v-model:placeholder to page from outside, or set default-placeholder to open on a month without selecting a day.
Events
The day slot draws a day's content, with { day, dayValue, selected, today, ... }. Keep dayValue: it's the number in the locale's digits. The dots are only drawn, so say the same thing in words, here with aria-describedby on the calendar.
Events on October 6, 9, 14 and 22.
October 14
- Team lunch
- 1:1 with Sam
Date picker
A Popover around the calendar. With initial-focus, the selected day or today takes focus when it opens; picking a day closes it.
Form
Formisch keeps the date as an ISO string, and the calendar gets parseDate(field.input) back. That's a new object on every render, which the calendar takes in its stride: it stays on the month you paged to. Press Sign up without a date.
Known limits
- Reka UI marks its Calendar as alpha (reka-ui#2789), so its behaviour still moves between minor versions. The tests pin what kappa relies on.
- Home, End, PageUp and PageDown need reka-ui 2.11 (reka-ui#2530). On 2.10 they do nothing.
- On reka-ui 2.10, a
v-modelrebuilt as a new object for the same day moved the view back to it (reka-ui#2960). The calendar works around it, so you don't have to. - With
multiple, clearing a day moves the view to the month of the last day still selected. That comes from Reka UI. - "Event Date", "Previous page" and "Next page" are English whatever the locale. Use a Field or
calendar-labelfor the first, and the parts witharia-labelfor the arrows, as shown under Accessibility. - Today's outline is worked out where the page renders. A prerendered page shows the day it was built; render the calendar on the client if that matters.
- Some automated checkers flag the
gridcells insiderole="application". Reka UI keeps the role on purpose, for NVDA (reka-ui#2438). disable-days-outside-current-viewdisables the neighbouring months' days but still shows them; with more than one month the calendar hides them itself, since the next grid draws them again (reka-ui#2730).
API Reference
Calendar draws the whole thing. For a layout of your own, put the parts in its default slot; they read the size from the root. Every part accepts class, merged over its base classes.
Calendar
| Prop | Default | Type and description |
|---|---|---|
| defaultValue | — | DateValueThe starting selection when |
| defaultPlaceholder | — | DateValueThe month to open on when |
| placeholder | — | DateValueA date in the month on screen, bound with |
| pagedNavigation | — | booleanMakes Previous and Next move by |
| preventDeselect | — | booleanKeeps a click on a selected day from clearing it. |
| weekStartsOn | — | WeekStartsOnThe first day of the week, from |
| weekdayFormat | — | WeekDayFormatHow the weekday headers are written: |
| calendarLabel | — | stringReplaces Reka's English "Event Date" in the root's accessible name. Inside a field, the field label is used instead. |
| fixedWeeks | true | booleanAlways draws six weeks, so the height doesn't change from month to month. |
| maxValue | — | DateValueThe latest date that can be picked. Later days are disabled, and Next stops at its month. |
| minValue | — | DateValueThe earliest date that can be picked. Earlier days are disabled, and Previous stops at its month. |
| locale | — | stringThe locale for month names, weekdays, digits and the week start. Defaults to the one Reka UI's |
| numberOfMonths | — | numberHow many months to show side by side. Below |
| disabled | — | booleanDisables every day and both arrows. Also set by a disabled field. |
| readonly | — | booleanKeeps the days focusable but not selectable. |
| initialFocus | — | booleanFocuses the selected day, today or the first focusable day on mount, skipping the hidden copies of other months' days. Useful in a popover. |
| isDateDisabled | — | MatcherReturns |
| isDateUnavailable | — | MatcherReturns |
| dir | — | DirectionThe reading direction, which also mirrors the arrow keys. Defaults to the one Reka UI's |
| nextPage | — | ((placeholder: DateValue) => DateValue)Returns the placeholder Next moves to, for custom paging. |
| prevPage | — | ((placeholder: DateValue) => DateValue)Returns the placeholder Previous moves to, for custom paging. |
| modelValue | undefined | DateValue | DateValue[] | nullThe selected date, bound with |
| multiple | — | booleanLets several days be selected; |
| disableDaysOutsideCurrentView | — | booleanDisables the days from the neighbouring months. They still show with one month; see |
| asChild | — | booleanRender the single child instead of the root, merging the root's attributes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| size | "md" | CalendarSizeSets the day cells, arrows, gaps and text from |
| color | "primary" | CalendarColorThe tone of the selected day and today's outline: |
| weekNumbers | — | booleanAdds a column of week numbers before each row, counted from the row's first day. Hidden from screen readers. |
| id | — | stringOverrides the |
| Event | Payload and description |
|---|---|
| update:modelValue | [date: DateValue | undefined]Fires with the picked date, the array with |
| update:placeholder | [date: DateValue]Fires when the month on screen changes. |
| Slot | Scope and description |
|---|---|
| default | { date: DateValue; grid: Grid<DateValue>[]; weekDays: string[]; weekStartsOn: WeekStartsOn; locale: string; fixedWeeks: boolean; modelValue: DateValue | DateValue[] | undefined; }Replaces the built-in layout, with Reka's |
| heading | { headingValue: string; date: DateValue; setPlaceholder: (date: DateValue) => void; }The heading's content, with |
| week-day | { day: string; index: number; }A weekday header's content, with |
| day | { day: DateValue; dayValue: string; selected: boolean; today: boolean; disabled: boolean; unavailable: boolean; outsideView: boolean; outsideVisibleView: boolean; }A day's content, with |
| prev-icon | anyThe Previous arrow's icon, a chevron by default. |
| next-icon | anyThe Next arrow's icon, a chevron by default. |
CalendarHeader
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a div, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The heading and the arrows. |
CalendarHeading
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a div, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| id | — | stringOverrides the id the root gives the heading for its |
| Slot | Scope and description |
|---|---|
| default | { headingValue: string; date: DateValue; setPlaceholder: (date: DateValue) => void; }The heading's content, with |
CalendarPrevButton
| Prop | Default | Type and description |
|---|---|---|
| prevPage | — | ((placeholder: DateValue) => DateValue)Returns the placeholder this button moves to, overriding the root's |
| asChild | — | booleanRender the single child instead of a button, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The icon, a chevron that flips in right-to-left layouts. |
CalendarNextButton
| Prop | Default | Type and description |
|---|---|---|
| nextPage | — | ((placeholder: DateValue) => DateValue)Returns the placeholder this button moves to, overriding the root's |
| asChild | — | booleanRender the single child instead of a button, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The icon, a chevron that flips in right-to-left layouts. |
CalendarGrid
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a table, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The head and body of one month. |
CalendarGridHead
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a thead, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The weekday row. |
CalendarGridBody
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a tbody, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The week rows. |
CalendarGridRow
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a tr, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}A week's cells, or the weekday headers. |
CalendarHeadCell
| Prop | Default | Type and description |
|---|---|---|
| asChild | — | booleanRender the single child instead of a th, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The weekday's name. |
CalendarCell
| Prop | Default | Type and description |
|---|---|---|
| date* | — | DateValueThe day this cell holds. |
| asChild | — | booleanRender the single child instead of a td, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | {}The day's trigger. |
CalendarCellTrigger
| Prop | Default | Type and description |
|---|---|---|
| day* | — | DateValueThe day this trigger picks. |
| month* | — | DateValueThe month of the grid it sits in, which tells days from the neighbouring months apart. |
| asChild | — | booleanRender the single child instead of a div, merging this part's attributes and classes onto it. |
| as | — | AsTag | ComponentThe element or component to render. |
| Slot | Scope and description |
|---|---|
| default | { dayValue: string; disabled: boolean; selected: boolean; today: boolean; outsideView: boolean; outsideVisibleView: boolean; unavailable: boolean; }The day's content, with |
Props
- defaultValue
DateValueThe starting selection whenv-modelis not used.- defaultPlaceholder
DateValueThe month to open on whenv-model:placeholderis not used. Defaults to the selection, or else today in the locale's calendar.- placeholder
DateValueA date in the month on screen, bound withv-model:placeholder. Moving it pages the calendar without selecting anything.- pagedNavigation
booleanMakes Previous and Next move bynumberOfMonthsinstead of one month.- preventDeselect
booleanKeeps a click on a selected day from clearing it.- weekStartsOn
WeekStartsOnThe first day of the week, from0(Sunday) to6. Leave it out to follow the locale.- weekdayFormat
WeekDayFormatHow the weekday headers are written:narrow(the default),shortorlong.- calendarLabel
stringReplaces Reka's English "Event Date" in the root's accessible name. Inside a field, the field label is used instead.- fixedWeeks
true booleanAlways draws six weeks, so the height doesn't change from month to month.- maxValue
DateValueThe latest date that can be picked. Later days are disabled, and Next stops at its month.- minValue
DateValueThe earliest date that can be picked. Earlier days are disabled, and Previous stops at its month.- locale
stringThe locale for month names, weekdays, digits and the week start. Defaults to the one Reka UI'sConfigProvidersets.- numberOfMonths
numberHow many months to show side by side. Belowsmthey stack. With more than one, the days outside each month are hidden.- disabled
booleanDisables every day and both arrows. Also set by a disabled field.- readonly
booleanKeeps the days focusable but not selectable.- initialFocus
booleanFocuses the selected day, today or the first focusable day on mount, skipping the hidden copies of other months' days. Useful in a popover.- isDateDisabled
MatcherReturnstruefor days that can't be picked or focused, such as weekends. Swapping the function works.- isDateUnavailable
MatcherReturnstruefor days that are struck through and can't be picked but stay focusable, such as fully booked ones. Swapping the function works.- dir
DirectionThe reading direction, which also mirrors the arrow keys. Defaults to the one Reka UI'sConfigProvidersets.- nextPage
((placeholder: DateValue) => DateValue)Returns the placeholder Next moves to, for custom paging.- prevPage
((placeholder: DateValue) => DateValue)Returns the placeholder Previous moves to, for custom paging.- modelValue
undefined DateValue | DateValue[] | nullThe selected date, bound withv-model: aDateValuefrom@internationalized/date, an array of them withmultiple, orundefined.- multiple
booleanLets several days be selected;v-modelis then an array.- disableDaysOutsideCurrentView
booleanDisables the days from the neighbouring months. They still show with one month; seenumberOfMonths.- asChild
booleanRender the single child instead of the root, merging the root's attributes onto it.- as
AsTag | ComponentThe element or component to render.- size
"md" CalendarSizeSets the day cells, arrows, gaps and text fromxstoxlon the [control scale](/docs/getting-started/sizing).md, 36px days, is the default.- color
"primary" CalendarColorThe tone of the selected day and today's outline:primary,neutral,destructive,success,warning,info, or a name you define.- weekNumbers
booleanAdds a column of week numbers before each row, counted from the row's first day. Hidden from screen readers.- id
stringOverrides theidtaken from a surrounding field. The heading's id is built from it.
Emits
- update:modelValue
[date: DateValue | undefined]Fires with the picked date, the array withmultiple, orundefinedwhen a day is cleared.- update:placeholder
[date: DateValue]Fires when the month on screen changes.
Slots
- default
{ date: DateValue; grid: Grid<DateValue>[]; weekDays: string[]; weekStartsOn: WeekStartsOn; locale: string; fixedWeeks: boolean; modelValue: DateValue | DateValue[] | undefined; }Replaces the built-in layout, with Reka's{ date, grid, weekDays, weekStartsOn, locale, fixedWeeks, modelValue }. Compose the parts in it.- heading
{ headingValue: string; date: DateValue; setPlaceholder: (date: DateValue) => void; }The heading's content, with{ headingValue, date, setPlaceholder }. Put month and year pickers here.- week-day
{ day: string; index: number; }A weekday header's content, with{ day, index }.- day
{ day: DateValue; dayValue: string; selected: boolean; today: boolean; disabled: boolean; unavailable: boolean; outsideView: boolean; outsideVisibleView: boolean; }A day's content, with{ day, dayValue, selected, today, disabled, unavailable, outsideView, outsideVisibleView }.dayValueis the number in the locale's digits.- prev-icon
anyThe Previous arrow's icon, a chevron by default.- next-icon
anyThe Next arrow's icon, a chevron by default.
Props
- asChild
booleanRender the single child instead of a div, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The heading and the arrows.
Props
- asChild
booleanRender the single child instead of a div, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.- id
stringOverrides the id the root gives the heading for itsaria-labelledby.
Slots
- default
{ headingValue: string; date: DateValue; setPlaceholder: (date: DateValue) => void; }The heading's content, with{ headingValue, date, setPlaceholder }.setPlaceholdermoves the view to a date's month without selecting it.
Props
- prevPage
((placeholder: DateValue) => DateValue)Returns the placeholder this button moves to, overriding the root'sprevPage.- asChild
booleanRender the single child instead of a button, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The icon, a chevron that flips in right-to-left layouts.
Props
- nextPage
((placeholder: DateValue) => DateValue)Returns the placeholder this button moves to, overriding the root'snextPage.- asChild
booleanRender the single child instead of a button, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The icon, a chevron that flips in right-to-left layouts.
Props
- asChild
booleanRender the single child instead of a table, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The head and body of one month.
Props
- asChild
booleanRender the single child instead of a thead, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The weekday row.
Props
- asChild
booleanRender the single child instead of a tbody, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The week rows.
Props
- asChild
booleanRender the single child instead of a tr, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}A week's cells, or the weekday headers.
Props
- asChild
booleanRender the single child instead of a th, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The weekday's name.
Props
- date*
DateValueThe day this cell holds.- asChild
booleanRender the single child instead of a td, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{}The day's trigger.
Props
- day*
DateValueThe day this trigger picks.- month*
DateValueThe month of the grid it sits in, which tells days from the neighbouring months apart.- asChild
booleanRender the single child instead of a div, merging this part's attributes and classes onto it.- as
AsTag | ComponentThe element or component to render.
Slots
- default
{ dayValue: string; disabled: boolean; selected: boolean; today: boolean; outsideView: boolean; outsideVisibleView: boolean; unavailable: boolean; }The day's content, with{ dayValue, selected, today, disabled, unavailable, outsideView, outsideVisibleView }. The number in the locale's digits by default.
Data attributes
| data-slot | Attributes | Description |
|---|---|---|
| calendar | data-size, data-color, data-months, data-disabled, data-readonly, data-invalid | The root, a role="group". data-months is set with more than one month. data-invalid means the selected day is disabled or unavailable. |
| calendar-header | — | The row with the heading and the arrows. |
| calendar-heading | data-disabled | The month and year. |
| calendar-prev-button | data-color, data-disabled | The Previous arrow, a ghost icon button in neutral. |
| calendar-next-button | data-color, data-disabled | The Next arrow. |
| calendar-months | — | The months, side by side from sm, stacked below. |
| calendar-grid | data-disabled, data-readonly | One month, a <table role="application">. |
| calendar-grid-head | — | The thead with the weekday names. |
| calendar-grid-body | — | The tbody with the weeks. |
| calendar-grid-row | — | A week, a tr. |
| calendar-head-cell | — | A weekday's name. |
| calendar-week-number | — | A week number, or the empty header above them. aria-hidden. |
| calendar-cell | data-disabled | A day's cell, a role="gridcell" with aria-selected. |
| calendar-cell-trigger | data-value, data-selected, data-today, data-disabled, data-unavailable, data-outside-view, data-outside-visible-view, data-focused | The day, a role="button" div labelled with the full date. data-outside-view marks the neighbouring months' days. |
Accessibility
Each day is announced with its full date, "Tuesday, October 6, 2026", in the calendar's locale. Only one day is in the tab order: the selected day, or the one the arrow keys last reached. Tab goes Previous, Next, the day, and out.
Reka UI names the root "Event Date, October 2026". In a Field, the field label replaces "Event Date". Elsewhere, set calendar-label. The arrows say "Previous page" and "Next page". To change that, compose the calendar from its parts and pass aria-label to CalendarPrevButton and CalendarNextButton.
The grid is a <table role="application">, so screen readers in browse mode hand the arrow keys to the calendar instead of reading the table.
Days are divs with role="button", not buttons: a <button> would put disabled days and the neighbouring months' days in the tab order, and submit the form around it on a click.
| Key | Action |
|---|---|
| ArrowLeft / ArrowRight | Moves to the previous or next day, flipped in right-to-left. Skips disabled days and turns the page at the month's edge. |
| ArrowUp / ArrowDown | Moves to the same day of the previous or next week. |
| Enter / Space | Selects the day, or clears it if it's selected. With multiple, toggles it. |
| Home / End | Moves to the first or last day of the week. Needs reka-ui 2.11 or later. |
| PageUp / PageDown | Moves to the same day of the previous or next month. Needs reka-ui 2.11 or later. |
| Shift + PageUp / Shift + PageDown | Moves to the same day of the previous or next year. Needs reka-ui 2.11 or later. |
| Ctrl + Enter | Isn't taken by the day, so it reaches the form around the calendar, for a submit shortcut. |