Range Calendar

new

From here to there, in two clicks. A calendar for the start and the end of something.

Demo
Stay, October - November 2026
October - November 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
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
1
2
3
4
5
6
7
8
9
10
11
12

Open Props in the corner of the example to try color, size and disabled.

Installation

It installs Calendar too, for the shared styles.

Usage

<script setup lang="ts">
import { CalendarDate } from '@internationalized/date'
import type { DateRange } from 'reka-ui'
import { RangeCalendar } from '@/components/ui/range-calendar'

const stay = shallowRef<DateRange | null>({
  start: new CalendarDate(2026, 10, 6),
  end: new CalendarDate(2026, 10, 12),
})
</script>

<template>
  <RangeCalendar v-model="stay" />
</template>

The first click picks the start, the second the end. Pick them in either order; the range comes back sorted. The ends are filled, the days between sit on a soft band, and while you choose the end a preview follows the pointer or the arrow keys.

v-model is { start, end } of @internationalized/date values. While the end is being picked it's { start, end: undefined }, so validate the whole range, or listen to update:valid-model-value, which fires only once both ends are there. Escape in the middle of a pick brings back the last complete range.

The demo above shows two months, with :number-of-months="2". They sit side by side from sm and stack below it, and with paged-navigation the arrows move by two. The days from the neighbouring months are hidden, band and all, since the other grid draws them again.

Everything else, from sizes and colours to locales, week numbers, slots and the Field wiring, works as on Calendar.

Examples

Maximum days

maximum-days caps the length: once a start is picked, the days beyond reach are disabled. A range can't cross unavailable days unless allow-non-contiguous-ranges is on.

Maximum days
Stay, October 2026
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

Book up to 7 days.

Presets

Set v-model from outside, and move v-model:placeholder with it so the range is on screen.

Presets
Report period, October 2026
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 picker

A Popover that closes on update:valid-model-value, so the first click doesn't close it. Escape mid-pick restores the last range and closes the popover in the same press.

Date picker

Form

Check-in and check-out kept as ISO strings by Formisch. The schema wants both, and a check-out after the check-in. Pick one day, then the same day again.

Form
Event Date, October 2026
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

Check-in from 3 pm, check-out by 11 am.

Known limits

  • update:model-value fires with half a range while the end is being picked (reka-ui#2396). Act on update:valid-model-value when only finished ranges matter.
  • Escape inside a popover both restores the range and closes the popover (reka-ui#1536).
  • The preview reuses the band's --tone-soft; there's no separate token for it yet.
  • Calendar's known limits apply here too, except the one about multiple.

API Reference

Every part accepts class, merged over its base classes.

Data attributes

The slots are Calendar's with a range- prefix. These differ:

data-slotAttributesDescription
range-calendardata-size, data-color, data-months, data-disabled, data-readonly, data-invalidThe root, a role="group". data-invalid means an end is disabled.
range-calendar-celldata-disabled, data-range-completeA day's cell. It draws the band, in --tone-soft. data-range-complete is set once the range has both ends, even when one of them is in a month off screen.
range-calendar-cell-triggerdata-value, data-selected, data-selection-start, data-selection-end, data-highlighted, data-highlighted-start, data-highlighted-end, data-today, data-disabled, data-unavailable, data-outside-viewThe day. data-selection-* mark the ends, data-highlighted* the preview while the end is picked.

Accessibility

As on Calendar, with aria-pressed on the days in the range and aria-selected on their cells.

KeyAction
ArrowLeft / ArrowRight / ArrowUp / ArrowDownMoves by a day or a week, flipped in right-to-left. While the end is being picked, the preview follows.
Enter / SpacePicks the start, then the end.
EscapeIn the middle of a pick, brings back the last complete range. Inside a popover it closes it too.
Home / EndMoves to the first or last day of the week. Needs reka-ui 2.11 or later.
PageUp / PageDownMoves by a month, or by a year with Shift. Needs reka-ui 2.11 or later.

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