UI Library

Prop Type Default Value Notes
closeOnSelectbooleanauto
Close the panel after a day pick; unset follows the control default (closes unless `time` is on).
formatstring?'YYYY-MM-DD'
Field pattern, dayjs tokens (YYYY, MM, DD, HH, mm, …); typed text is parsed against it and [bracketed] text is literal. Defaults to YYYY-MM-DD, or YYYY-MM-DD HH:mm:ss while `time` is on.
fromstring?''
Range start as YYYY-MM-DD (a date-time while `time` is on); an invalid date reads as unset. Applies while `range` is on; the eye resets to the default.
hideOutlinebooleanfalse
Drops each bordered field’s border and focus border while keeping its surface, padding, and text metrics.
highlightRangebooleanfalse
Highlight the days between the two ends in each end’s calendar, so the range reads as one span; the ends stay the selected days. Applies while `range` is on.
placeholderstring?—
Prompt shown while the single field is empty; defaults to the shared message. A range pair names each field after its own end.
rangebooleanfalse
Render a from/to pair of independent fields, each behaving as the single field with its own calendar.
ratiosPickerRatioOverrides?—
Partial override of the field-gutter and calendar ratios; the field text follows the picker font and paddings.
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'
Control scale; numbers are icon-scale pixels. Scales every field and its calendar.
timebooleanfalse
Edit a date-time: every panel gains an hour/minute/second row, and a range pairs two date-time fields. A segment stepped past its range carries into the next unit (23:59:59 + 1s rolls the date).
tostring?''
Range end as YYYY-MM-DD (a date-time while `time` is on); an invalid date reads as unset. Applies while `range` is on; the eye resets to the default.
valuestring?''
Selected date as YYYY-MM-DD (a date-time while `time` is on); an invalid date reads as unset. Applies while `range` is off. Typing is validated on commit (a valid date writes back, anything else reverts); the eye resets to the default.
variant'bordered' | 'embedded''bordered'
Chrome variant; embedded drops each field’s border, the background, and the focus ring for a picker rendered inside another surface.
themeDateInputTheme?——Optional per-part color overrides; omitted keys keep the app palette.
onChange(value: string) => void——Called with the picked date (or reset) while `range` is off.
onFrom(value: string) => void——Called with the picked range start (or reset).
onTo(value: string) => void——Called with the picked range end (or reset).