MindeesUI
ComponentsForms

DateRangePicker

A trigger that opens a calendar to pick a start and end date, normalising the order automatically.

DateRangePicker selects a { start, end } range from a Calendar in a modal. The first tap sets the start, the second completes the range (swapping if it lands before the start), and a third restarts. The trigger summarises the chosen range.

Import

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

Usage

<DateRangePicker value={range} onChange={setRange} placeholder="Select range…" />

Props

PropTypeDefaultDescription
valueDateRangeCurrently-selected { start?, end? } range.
onChange(range: DateRange) => voidFires whenever the range changes.
placeholderstring'Select range…'Shown on the trigger when no range is selected.
format(date: Date) => stringlocale date stringFormat a single endpoint 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 with disabled/expanded state and forwards FormField labelling. The modal is labelled Pick a date range, and the calendar exposes per-day buttons with selected state.

On this page