Date Picker

new

Type it if you know it, pick it if you don't. Nobody remembers what day the 14th is.

Demo
10
30
2026

Type the date or pick it from the calendar.

Open Props in the corner of the example to try variant, size, disabled and readonly. disabled turns off the segments, the button and the calendar. readonly keeps the field focusable and the calendar viewable, but nothing can be picked. Field's invalid and required reach it too.

The five text control variants, the same as on Input. While the calendar is open, the frame keeps its focus colour.

The field runs from 28px at xs to 48px at xl, and the calendar takes the same size: an xl field opens 48px days. Give DatePickerCalendar its own size to break the pair. For touch, lg or xl days are easier to hit.

Installation

Usage

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

const date = shallowRef<DateValue | undefined>(new CalendarDate(2026, 10, 6))
</script>

<template>
  <DatePicker v-model="date" locale="en-US" aria-label="Due date" />
</template>

It's an InputDate with a calendar button at the end. The button opens a Calendar in a popover, so people who know the date type it and the rest pick it. Both edit the same v-model.

v-model is a CalendarDate from @internationalized/date, or undefined until every segment is filled. Set name, and it submits as YYYY-MM-DD.

Picking a day closes the calendar and puts focus back on the button. Clicking the selected day again keeps it; Reka UI would clear it.

Pass locale, or set it once on Reka UI's ConfigProvider. Without one, you get en: month first, Sunday first, whatever your users expect.

Put it in a Field, or give it an aria-label.

Examples

Button trigger

The shadcn look: an outline button that shows the date. Compose the parts, hand the trigger to your Button with as-child, and put DatePickerValue inside. In a Field, the button takes the label, the description and the invalid state, and a name still submits through a hidden input.

With a button

Unavailable dates

is-date-disabled takes days off the calendar, such as weekends. is-date-unavailable strikes them through but keeps them in the arrow-key path, for days that exist but are full. Either one, typed into the field, marks it invalid.

min-value and max-value disable the days outside them and stop the arrows at their months.

Unavailable dates
mm
dd
yyyy

Weekdays in the next two months. Struck-through days are full.

Date of birth

Paging back forty years a month at a time is nobody's idea of fun. The calendar's heading slot takes month and year selects; setPlaceholder moves the view without picking a day.

default-placeholder sets where the calendar opens while there is no date.

Birthday
mm
dd
yyyy

Jump to the year from the calendar's heading.

Date and time

Pass a CalendarDateTime and set granularity, and the time segments follow the date in the field. Picking a day keeps the typed time.

With time segments the calendar stays open after a pick, so the time can be set next. Add a Done button under the calendar, or set close-on-select.

With time
16
10
2026

Presets

DatePickerContent takes anything after the calendar. Buttons that set v-model and close with v-model:open make quick picks.

Presets
mm
dd
yyyy

Locale

The segment order, the month names and the first day of the week all come from the locale. In right-to-left, the arrows and the arrow keys flip too.

Locale
6
10
2026
٦
١٠
٢٠٢٦

In an input group

Inside an InputGroup the picker drops its own frame and takes the group's variant and size.

In an input group
Starts
10
6
2026

In a dialog

The calendar opens above the dialog, and picking a day doesn't close it.

In a dialog

Form

focus and blur fire once for the whole picker: moving from the segments to the button to the calendar, or to a select in the calendar's heading, isn't leaving it. So a form that validates on blur doesn't flag an empty field the moment the calendar opens, and a pick in the calendar is checked like typing.

To keep an ISO string in the form, convert at the boundary, and parse each string only once: a new CalendarDate on every render is a new value each time. Register the first segment with the form library so it can focus the field after a failed submit.

Form
mm
dd
yyyy

Weekdays only.

Known limits

The picker is built from Reka UI's DateField and Calendar, which are still alpha upstream (reka-ui#2789).

  • Typing into the last segment never stops: a fifth year digit starts the year over (reka-ui#2002).
  • A half-typed date is undefined, the same as an empty one, so "required" and "incomplete" read alike (nuxt/ui#6244).
  • Home, End, PageUp and PageDown in the calendar need reka-ui 2.11 (reka-ui#2530). On 2.10 they do nothing.
  • The segments' screen reader labels ("day", "month", "year") and the calendar's "Previous page" and "Next page" are English whatever the locale (reka-ui#2366). The trigger's "Open calendar" takes an aria-label.
  • Without locale or a ConfigProvider, the order is en's: month, day, year (nuxt/ui#5552).
  • On reka-ui 2.10, a v-model rebuilt as a new object for the same day moved the calendar back to it (reka-ui#2960). The picker works around it, so paging survives a form that re-parses its value.

API Reference

DatePicker on its own renders the field and the calendar. To change either, put the parts in its default slot. Every part with an element accepts class, merged over its base classes; on the root it goes to the field.

Data attributes

DatePickerCalendar is a Calendar and the field holds an InputDate; their attributes apply.

data-slotAttributesDescription
date-picker-inputdata-variant, data-size, data-state, data-disabledThe frame around the segments and the trigger. data-state is open while the calendar is. Inside an input group, the group is the frame.
date-picker-triggerdata-state, data-color, aria-expandedThe calendar button, a ghost icon button in neutral. With as-child, your button carries it.
date-picker-valuedata-placeholderThe formatted date, or the placeholder text.
date-picker-contentdata-state, data-side, data-alignThe popover around the calendar, a role="dialog".
date-picker-scrim—The transparent layer under a modal picker that takes the first outside click.
date-picker-native-input—The hidden input that submits the date and checks required when the trigger is a button.

Accessibility

The field is a group labelled by its Field, with a spinbutton for each segment, as on InputDate. The button after it says "Open calendar" and is announced as opening a dialog; pass your own aria-label to change it.

When it opens, focus goes to the selected day, else today, else the first day you can pick. Reka UI's own first focus can land on a hidden copy of the day in the neighbouring month and then focus nothing; the picker skips those. Escape, or a pick, closes it and returns focus to the button.

With a button trigger, the button is the control: it takes the Field's id, so the label points at it, and it's named by the label and its text together: "Publish on Oct 6, 2026".

KeyAction
Tab / Shift + TabMoves through the segments, then to the calendar button, then out. In the open calendar, it goes round the arrows and the days.
0–9Types into the segment and moves to the next one when it is full.
ArrowUp / ArrowDownIn a segment, steps it. In the calendar, moves a week.
ArrowLeft / ArrowRightMoves between the segments. In the calendar, moves a day, flipped in right-to-left.
Alt + ArrowDownOpens the calendar from a segment, as on a native date input.
Enter / SpaceOn the button, opens or closes the calendar. On a day, picks it.
Home / EndMoves to the first or last day of the week. Needs reka-ui 2.11 or later.
PageUp / PageDownMoves a month; with Shift, a year. Needs reka-ui 2.11 or later.
EscapeCloses the calendar without a change and returns focus to the button.
EnterIn a segment, submits the form, like a native date input.

Changelog

  1. core 0.17.0

    0107e40 — The scrollbar's space is kept only while an overlay locks scrolling, as Base UI does, instead of on every page. @kappa-ui/core/tailwind.css no longer sets html { scrollbar-gutter: stable }, so a page too short to scroll no longer shows an empty strip along its edge on Windows. Dialog, Drawer, Select, Menu, Popover and DatePicker set scrollbar-gutter: stable on <html> while the page is locked and it would otherwise scroll, and remove it afterwards; a gutter your stylesheet already reserves is left alone. Keep ConfigProvider with :scroll-body="false". Want the old always-on gutter? Add html { scrollbar-gutter: stable; } to your stylesheet.

  2. registry 0.22.0

    552297f — The text-control frame moves to its own lib item text-control; Select, Combobox, DatePicker and the other text controls import it from @/lib/text-control instead of @/ui/input.

    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.

    7f34747 — Menubar triggers take the line height of their size's label scale; they read a variable nothing defined and fell back to 1.5 times the font size.

    ee25b0f — The modal scrim's hold renders a comment instead of a hidden <span>, and PopoverContent, DatePickerContent and Menu put it after their slot: PopoverContent as-child renders the consumer's element as the panel instead of moving the panel's role, classes and data-slot onto the hidden span, and a panel's first element child is the consumer's again.

    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.

    70d1620 — Colours written inside arbitrary values and variables now resolve where the element sits, so a .dark island (or any subtree that sets a token) gets its own: the filled Input, InputGroup and DatePicker underline, the Table hover, selected and stripe tints, the disabled Slider and Rating fills and the ColorPicker checkerboard read --theme(--color-x) instead of var(--color-x), which Tailwind resolves once on :root. The ripple wave reads --state-pressed where it is pressed (the ripple item no longer pins --kappa-ripple-opacity on :root), so a subtree that changes --state-pressed changes the wave as well as the state layer.

  3. core 0.16.0

    ee25b0f — The modal scrim's hold renders a comment instead of a hidden <span>, and PopoverContent, DatePickerContent and Menu put it after their slot: PopoverContent as-child renders the consumer's element as the panel instead of moving the panel's role, classes and data-slot onto the hidden span, and a panel's first element child is the consumer's again.

    70d1620 — Colours written inside arbitrary values and variables now resolve where the element sits, so a .dark island (or any subtree that sets a token) gets its own: the filled Input, InputGroup and DatePicker underline, the Table hover, selected and stripe tints, the disabled Slider and Rating fills and the ColorPicker checkerboard read --theme(--color-x) instead of var(--color-x), which Tailwind resolves once on :root. The ripple wave reads --state-pressed where it is pressed (the ripple item no longer pins --kappa-ripple-opacity on :root), so a subtree that changes --state-pressed changes the wave as well as the state layer.

  4. registry 0.18.0

    779955e — Corners come in three roles: rounded-control-*, rounded-surface-* and rounded-item-*, each scaled from --radius and tunable on its own with --control-radius, --surface-radius and --item-radius, on :root or any element. Every component uses them, and cn() merges them, so a class prop still wins.

    - --control-radius was the Input family's frame variable. It now sets every control, and the frames use --frame-radius. - Nested parts no longer turn square at small radii: the InputGroup button, the InputNumber steppers, the TagsInput chips, the DatePicker trigger and the Toast and Tour close buttons. - Menus, lists, pill tabs, the menubar and the toolbar wrap their corners around their items. Pill tabs are rounder (12/8px at md instead of 8/4px), menus and lists grow by up to 2px, and their rows at sizes xs and xl follow their height. Item sm takes 8px instead of 6.4px.

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

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