MindeesUI
ComponentsForms

DatePicker

A trigger that opens a calendar in a modal to pick a single date, with locale-aware formatting.

DatePicker shows a trigger with the selected date (or a placeholder) and a chevron. Tapping it opens a Calendar inside a centered modal; choosing a day fires onChange and closes the modal. Formatting defaults to the runtime locale and is overridable.

Import

import { DatePicker } from '@mindees/ui';

Usage

<DatePicker value={date} onChange={setDate} placeholder="Select date…" />

Props

PropTypeDefaultDescription
valueDateCurrently-selected date (controlled).
onChange(date: Date) => voidFires when a day is picked from the calendar.
placeholderstring'Select date…'Shown on the trigger when no date is selected.
format(date: Date) => stringlocale date stringFormat the selected date for the trigger label.
disabledbooleaninheritedForce a disabled state outside of a FormField.
invalidbooleaninheritedForce an invalid state outside of a FormField.
styleStyleProp<ViewStyle>Style applied to the trigger container.

Accessibility

The trigger is a button exposing disabled/expanded state and forwards FormField labelling (accessibilityLabelledBy, aria-invalid, aria-required). The modal is labelled Pick a date, and the calendar's day cells are individually labelled buttons.

On this page