Data Entryduskmoonimplemented16 demos

DatePicker

DatePicker captures single dates and related date-picker states with typed callbacks.

Import@duskmoon-dev/components/date-picker
11API sections
33documented props
14behavior scenarios
Key API
inputPropsvaluedefaultValueonChangeonBluronFocus

Usage

When to use

  • Use it inside forms, filters, settings, and any workflow that captures user input.
  • Prefer controlled props when the value must stay synchronized with application state.

Implementation notes

StylesheetImport @duskmoon-dev/components/styles.css once in the app or docs shell.
StateStart with default props for static examples, then switch to controlled props when state must be shared.
ThemeThe preview inherits the active DuskMoon data-theme value from the docs layout.

Features

Controlled and uncontrolled usage

Documents default values, value props, and change callbacks for form integration.

Validation state

Surfaces status, size, disabled, and option data patterns where the component supports them.

Primary API surface

DatePicker is most often configured through `inputProps`, `value`, `defaultValue`, `onChange`.

Covered behavior

Renders one complete decorative calendar SVG inside the accessible dropdown trigger

Feature Demos

Feature demos are authored for the component page, then supplemented with behavior scenarios from the component test coverage.

Preview

Basic usage

authored

Import the component stylesheet and DatePicker from its package subpath, then render it with the core props.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function Example() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Renders one complete decorative calendar SVG inside the accessible dropdown trigger

test-backed

DatePicker scenario from the component test coverage: renders one complete decorative calendar svg inside the accessible dropdown trigger.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerRendersOneCompleteDecorativeDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Year drilldown preserves controlled value and open state

test-backed

DatePicker scenario from the component test coverage: year drilldown preserves controlled value and open state.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerYearDrilldownPreservesControlledDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Browses year and month without committing until an enabled day is selected

test-backed

DatePicker scenario from the component test coverage: browses year and month without committing until an enabled day is selected.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerBrowsesYearAndMonthDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Month picker still commits a month string and closes

test-backed

DatePicker scenario from the component test coverage: month picker still commits a month string and closes.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerMonthPickerStillCommitsDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Opens a default calendar by icon or input and commits an enabled date

test-backed

DatePicker scenario from the component test coverage: opens a default calendar by icon or input and commits an enabled date.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerOpensADefaultCalendarDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Honors controlled open and disabled states

test-backed

DatePicker scenario from the component test coverage: honors controlled open and disabled states.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerHonorsControlledOpenAndDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Renders picker input with value, size, status, and classes

test-backed

DatePicker scenario from the component test coverage: renders picker input with value, size, status, and classes.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerRendersPickerInputWithDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Supports uncontrolled changes and clear

test-backed

DatePicker scenario from the component test coverage: supports uncontrolled changes and clear.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerSupportsUncontrolledChangesAndDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Supports presets and showNow

test-backed

DatePicker scenario from the component test coverage: supports presets and shownow.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerSupportsPresetsAndShowNowDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Blocks disabledDate values

test-backed

DatePicker scenario from the component test coverage: blocks disableddate values.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerBlocksDisabledDateValuesDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Supports range picker values

test-backed

DatePicker scenario from the component test coverage: supports range picker values.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerSupportsRangePickerValuesDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Exposes static picker aliases

test-backed

DatePicker scenario from the component test coverage: exposes static picker aliases.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerExposesStaticPickerAliasesDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Forwards native input labels and errors without overriding controlled behavior

test-backed

DatePicker scenario from the component test coverage: forwards native input labels and errors without overriding controlled behavior.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerForwardsNativeInputLabelsDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview

Range inputs inherit attributes with distinct native ids

test-backed

DatePicker scenario from the component test coverage: range inputs inherit attributes with distinct native ids.

Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";

export function DatePickerRangeInputsInheritAttributesDemo() {
  return (<DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>);
}
Preview
Sunshine Theme
Moonlight Theme

Theme aware

authored

Docs previews inherit the DuskMoon data-theme value. Use the header switch to compare light and dark rendering.

Source
<div data-theme="sunshine">
  <DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>
</div>

<div data-theme="moonlight">
  <DatePicker
  defaultValue="2026-05-25"
  size="lg"
  status="success"
  onChange={(value) => console.log(value)}
/>
</div>

API

The API reference below lists every parsed exported type or interface for DatePicker. Start with `inputProps`, `value`, `defaultValue`, `onChange` for common usage.

Types: packages/components/src/components/date-picker/DatePicker.types.tsScenarios: packages/components/src/components/date-picker/DatePicker.test.tsx
DatePickerPropsinterface extends Omit< ComponentProps<"div">, "children" | "defaultValue" | "onBlur" | "onChange" | "onFocus" >
PropTypeRequiredDescription
inputPropsComponentProps<"input">NoinputProps configures DatePicker.
valueDatePickerValueNovalue configures DatePicker.
defaultValueDatePickerValueNodefaultValue configures DatePicker.
onChange(value: DatePickerValue | undefined, dateString: string) => voidNoonChange configures DatePicker.
onBlur(event: DatePickerInputFocusEvent) => voidNoonBlur configures DatePicker.
onFocus(event: DatePickerInputFocusEvent) => voidNoonFocus configures DatePicker.
onOpenChange(open: boolean) => voidNoonOpenChange configures DatePicker.
pickerDatePickerPickerNopicker configures DatePicker.
formatstringNoformat configures DatePicker.
placeholderstringNoplaceholder configures DatePicker.
disabledbooleanNodisabled configures DatePicker.
disabledDate(value: DatePickerValue) => booleanNodisabledDate configures DatePicker.
presetsDatePickerPreset[]Nopresets configures DatePicker.
showNowbooleanNoshowNow configures DatePicker.
allowClearbooleanNoallowClear configures DatePicker.
openbooleanNoopen configures DatePicker.
defaultOpenbooleanNodefaultOpen configures DatePicker.
sizeDatePickerSizeNosize configures DatePicker.
statusDatePickerStatusNostatus configures DatePicker.
DatePickerPresetinterface
PropTypeRequiredDescription
labelReactNodeYeslabel configures DatePicker.
valueDatePickerValueYesvalue configures DatePicker.
RangePickerPropsinterface extends Omit< DatePickerProps, "placeholder" | "value" | "defaultValue" | "onChange" >
PropTypeRequiredDescription
valueDatePickerRangeValueNovalue configures DatePicker.
defaultValueDatePickerRangeValueNodefaultValue configures DatePicker.
onChange(NoonChange configures DatePicker.
valueDatePickerRangeValue,Yesvalue configures DatePicker.
dateStrings[string, string],YesdateStrings configures DatePicker.
placeholder[string, string]Noplaceholder configures DatePicker.
separatorReactNodeNoseparator configures DatePicker.
DatePickerComponentinterface extends ForwardRefExoticComponent< DatePickerProps & RefAttributes<HTMLDivElement> >
PropTypeRequiredDescription
RangePickerForwardRefExoticComponent<YesRangePicker configures DatePicker.
WeekPickerForwardRefExoticComponent<YesWeekPicker configures DatePicker.
MonthPickerForwardRefExoticComponent<YesMonthPicker configures DatePicker.
QuarterPickerForwardRefExoticComponent<YesQuarterPicker configures DatePicker.
YearPickerForwardRefExoticComponent<YesYearPicker configures DatePicker.
DatePickerValuetype
Type definition
string
DatePickerRangeValuetype
Type definition
[ DatePickerValue | undefined, DatePickerValue | undefined, ]
DatePickerPickertype
Type definition
"date" | "week" | "month" | "quarter" | "year" | "time"
DatePickerSizetype
Type definition
"sm" | "md" | "lg"
DatePickerStatustype
Type definition
"error" | "success"
DatePickerInputChangeEventtype
Type definition
ChangeEvent<HTMLInputElement>
DatePickerInputFocusEventtype
Type definition
FocusEvent<HTMLInputElement>