Date Range Picker

new

Check-in, check-out, and a calendar for the bit in between. Late checkout not included.

Date range picker
10
23
2026
11
2
2026

Pick the first day, then the last.

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

Installation

It installs the Date Picker with it, whose trigger and panel it shares.

Usage

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

const trip = shallowRef<DateRange | null>({
  start: new CalendarDate(2026, 10, 23),
  end: new CalendarDate(2026, 11, 2),
})
</script>

<template>
  <DateRangePicker v-model="trip" :number-of-months="2" locale="en-US" aria-label="Trip" />
</template>

An InputDateRange with a calendar button, opening a RangeCalendar. Type both ends, or click the first day and then the last; the days between fill in as you go, and the calendar closes once there is an end.

v-model is { start, end }. While the end is being picked, end is undefined. Escape in the middle of a pick puts the last range back.

Two months side by side need about 560px. The demo above shows one on a phone, switching number-of-months with useMediaQuery; below sm the calendar stacks its months anyway.

Set name, and the form gets two fields, name[start] and name[end], each an ISO date and empty until that end is set. Reka UI's own range input would send "undefined - undefined" and never fail required, so the picker doesn't use it. required needs both ends.

Everything else, from locale to sizes and Field wiring, works as on the Date Picker.

Examples

Button trigger

A dashboard filter: a button showing the period, with presets beside the calendar. DateRangePickerValue joins the ends with formatRange, which writes what they share once: "Oct 6 – 12, 2026".

With a button

Form

Hotel nights in a plain form. maximum-days caps the stay once the check-in is picked, and a stay can't cross a sold-out night unless allow-non-contiguous-ranges is on.

Form
mm
dd
yyyy
mm
dd
yyyy

Up to two weeks. Struck-through nights are sold out.

Known limits

The same as the Date Picker's, and:

  • step-snapping isn't there for ranges: Reka UI's range field doesn't have it.
  • With two months, the days of a neighbouring month are hidden rather than muted: Reka marks them selected too, and the range would show twice (reka-ui#2730).

API Reference

DateRangePicker on its own renders the field and the calendar; put the parts in its default slot to change them. DateRangePickerTrigger and DateRangePickerContent are DatePickerTrigger and DatePickerContent under range names, so their API is below.

Data attributes

DateRangePickerCalendar is a RangeCalendar and the field holds an InputDateRange; their attributes apply.

data-slotAttributesDescription
date-range-picker-inputdata-variant, data-size, data-state, data-disabledThe frame around both ends and the trigger. data-state is open while the calendar is.
date-picker-triggerdata-state, data-color, aria-expandedThe calendar button.
date-range-picker-valuedata-placeholderThe formatted range, or the placeholder text.
date-picker-contentdata-state, data-side, data-alignThe popover around the calendar, a role="dialog".
date-range-picker-native-input—The hidden inputs, name[start] and name[end], when the trigger is a button.

Accessibility

As on the Date Picker. When the calendar opens, focus goes to the start, else today. Each day in the range is announced as selected; moving over the days after a start previews the range.

KeyAction
Tab / Shift + TabMoves through the start's segments, the end's, then the calendar button.
Alt + ArrowDownOpens the calendar from a segment.
Arrow keysIn the calendar, move a day or a week. After a start, they preview the range.
Enter / SpacePicks the start, then the end.
EscapeCloses the calendar. In the middle of a pick, the last range comes back.

Changelog

  1. registry 0.22.0

    897f2ac — An InputGroup holding a DatePicker or DateRangePicker keeps its frame in the focus colour while the calendar is open, as the picker's own frame does; focus has moved into the calendar, so the group's focus rule no longer matched.

    6ad0607 — DatePickerCalendar and DateRangePickerCalendar render a fresh calendar each time the picker opens. With force-mount, or when the picker reopened during its close animation, the still-mounted calendar lost its placeholder when the picker reset it, threw and came back empty.

    2b1d39a — DatePicker and DateRangePicker keep a bound modelValue, open or placeholder until the parent changes it: a parent that refuses a picked date, or binds open to false without a listener, no longer sees the picker show a value or a panel it never accepted. Unbound, they keep their own state as before.

  2. registry 0.13.1

    84b03c8 — DateRangePicker installs and type-checks in a fresh project. Its index.ts re-exported the shared DatePicker parts with export … from, and the shadcn-vue CLI rewrites the alias only in imports, so the installed file still pointed at @/registry/kappa-ui/ui/date-picker.

  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.