Skip to content
ZikZuk UI

DateField

Stripe DateField

An underline field that opens the kit calendar in a popover and reads “22 Oct 2026”. The value is a plain yyyy-MM-dd string; days outside min and max can't be picked. With a label it renders the whole field — label, description, red error — wired up for screen readers; without one, just the control for a Field of your own.

pnpm add @zikzuk/ui
import { DateField } from "@zikzuk/ui";

With limits, and with an error

The first day the limit applies.

When to use

  • A single date in a form: a start date, an expiry.

Not for

  • Filtering a list by dates — DateRangeFilter.

Props

PropTypeDescription
value / onChangestring / (value) => voidyyyy-MM-dd or "" (controlled).
defaultValuestringUncontrolled start.
labelReactNodeRenders the whole field.
descriptionReactNodeGrey help under the field.
errorReactNodeRed, announced; marks it invalid.
min / maxstringEarliest and latest allowed day.
placeholderstring
Default "Pick a date"
Shown when empty.
namestringSubmits the value with a native form.
disabled / invalidbooleanStates.
classNamestringExtra classes on the outer element.