Calendar

new

Thirty days hath September, and this grid knows all of them. A month to pick a date from.

Demo
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Event Date, October 2026

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.

Multiple
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
On-call days, October 2026

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.

Min and max
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Booking date, October 2026

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.

Disabled dates
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Delivery date, October 2026

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.

Unavailable dates
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Table for two, October 2026

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.

Week numbers
Januar 2027
28
29
30
31
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Datum, Januar 2027
de-DE, ISO weeks
January 2027
28
29
30
31
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Date, January 2027
en-US, Monday first

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()).

Locale
أكتوبر ٢٠٢٦
٢٦
٢٧
٢٨
٢٩
٣٠
١
٢
٣
٤
٥
٦
٧
٨
٩
١٠
١١
١٢
١٣
١٤
١٥
١٦
١٧
١٨
١٩
٢٠
٢١
٢٢
٢٣
٢٤
٢٥
٢٦
٢٧
٢٨
٢٩
٣٠
٣١
١
٢
٣
٤
٥
٦
التاريخ, أكتوبر ٢٠٢٦
ar-EG
۱۴۰۵ مهر
۲۸
۲۹
۳۰
۳۱
۱
۲
۳
۴
۵
۶
۷
۸
۹
۱۰
۱۱
۱۲
۱۳
۱۴
۱۵
۱۶
۱۷
۱۸
۱۹
۲۰
۲۱
۲۲
۲۳
۲۴
۲۵
۲۶
۲۷
۲۸
۲۹
۳۰
۱
۲
۳
۴
۵
۶
۷
۸
تاریخ, ۱۴۰۵ مهر
fa-IR, Persian calendar

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.

Month and year select
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
8
9
Birthday, May 1990

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.

Placeholder
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Date, October 2026

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
October 2026
27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
6
7
Team calendar, October 2026

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.

Date picker

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.

Form
January 2000
26
27
28
29
30
31
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
1
2
3
4
5
Event Date, January 2000

We only check that you're 18 or over.

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-model rebuilt 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-label for the first, and the parts with aria-label for 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 inside role="application". Reka UI keeps the role on purpose, for NVDA (reka-ui#2438).
  • disable-days-outside-current-view disables 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.

Data attributes

data-slotAttributesDescription
calendardata-size, data-color, data-months, data-disabled, data-readonly, data-invalidThe 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-headingdata-disabledThe month and year.
calendar-prev-buttondata-color, data-disabledThe Previous arrow, a ghost icon button in neutral.
calendar-next-buttondata-color, data-disabledThe Next arrow.
calendar-months—The months, side by side from sm, stacked below.
calendar-griddata-disabled, data-readonlyOne 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-celldata-disabledA day's cell, a role="gridcell" with aria-selected.
calendar-cell-triggerdata-value, data-selected, data-today, data-disabled, data-unavailable, data-outside-view, data-outside-visible-view, data-focusedThe 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.

KeyAction
ArrowLeft / ArrowRightMoves to the previous or next day, flipped in right-to-left. Skips disabled days and turns the page at the month's edge.
ArrowUp / ArrowDownMoves to the same day of the previous or next week.
Enter / SpaceSelects the day, or clears it if it's selected. With multiple, toggles it.
Home / EndMoves to the first or last day of the week. Needs reka-ui 2.11 or later.
PageUp / PageDownMoves to the same day of the previous or next month. Needs reka-ui 2.11 or later.
Shift + PageUp / Shift + PageDownMoves to the same day of the previous or next year. Needs reka-ui 2.11 or later.
Ctrl + EnterIsn't taken by the day, so it reaches the form around the calendar, for a submit shortcut.

Changelog

  1. registry 0.22.0

    53b65fd — Week numbers in Calendar and RangeCalendar stay within 1 to 53 in a non-Gregorian calendar such as fa-IR's Persian one: each row's first day is converted to the Gregorian calendar before Reka numbers it, instead of being diffed against January 1 of the same year number in the Gregorian calendar.

    1424429 — A disabled RangeCalendar draws its range ends in the disabled fill, like a disabled Calendar's selected day, instead of solid destructive red: Reka reports every day of a disabled calendar as unavailable, which marked the value invalid, and a calendar root no longer takes the invalid tone while it is disabled.

  2. registry 0.19.0

    adf96cd — Parts no longer style themselves from their root's size through group-data-[size=…] variants, which beat any plain class of yours. size is the density of the root, and a class on a part wins:

    - Card, Empty, Alert and Stepper: CardTitle, CardDescription, EmptyTitle, EmptyDescription, AlertTitle, AlertDescription, StepperTitle and StepperDescription keep one text size at every root size (title-md/body-md, title-sm/body-md for Alert, title-sm/body-sm for Stepper). Empty's icon and gaps and Stepper's indicator number still follow the size, through --empty-icon, --empty-header-gap, --empty-content-gap and --stepper-text on the root. - Menu and DrawerMenu labels, Menubar triggers and the Calendar heading, weekday cells and week numbers keep scaling with the size, through --menu-label, --menubar-text, --calendar-heading and --calendar-label (each with a -leading twin) set by the root. - AlertDialog size="sm" centres its text through the content, so text-start on AlertDialogHeader wins; the footer keeps its two-column grid.

  3. registry 0.13.0

    d9c272f — New DatePicker and DateRangePicker: an InputDate or InputDateRange with a calendar button that opens a Calendar or RangeCalendar in a popover, so a date can be typed or picked into the same v-model. <DatePicker v-model="date" /> renders the whole thing; the parts (DatePickerInput, DatePickerTrigger, DatePickerValue, DatePickerContent, DatePickerCalendar and their range twins) compose a layout of your own, including the shadcn-style outline button with DatePickerTrigger as-child. The field comes in Input's five variants and five sizes, the calendar follows the field's size unless it has its own, and inside an InputGroup the picker takes the group's frame. Picking a day closes the calendar (not when there are time segments, whose typed time a pick keeps), clicking the selected day keeps it, every month draws six weeks so the panel doesn't jump, and Alt+ArrowDown opens it from a segment. Focus on open lands on the selected day, today or the first day you can pick, never on a hidden copy from the neighbouring month. focus and blur fire once for the field, the button and the calendar together, so validate-on-blur doesn't flag the field while the calendar is open. In a Field, a button trigger takes the label, the description and the invalid state, and name submits through a hidden input: YYYY-MM-DD for a date, name[start] and name[end] for a range, with required needing both ends.

    7376882 — New Calendar and RangeCalendar: month grids over Reka UI's Calendar and RangeCalendar, in Material 3 look, with the heading at the start, the arrows at the end and round days. Calendar picks one date or several; RangeCalendar picks a start and an end, fills both and draws a soft band between them, with a preview while the end is picked. Both come in five sizes on the control scale (xs to xl, 36px days at md), take color, show several months side by side with the neighbouring months' days hidden, add week numbers with week-numbers, and wire to Field: the field label and the month name label the calendar, and an invalid field turns the selection destructive. Each part is exported for a layout of your own, and a heading slot with setPlaceholder takes month and year pickers. is-date-disabled and is-date-unavailable can be swapped after mount, initial-focus skips the hidden copies of other months' days, and on reka-ui 2.10 a v-model rebuilt as a new object for the same day no longer sends the view back to its month.