Introducing PrimeReact v11-alpha 🎉Discover Now

DatePicker

An unstyled date picker component with calendar navigation, view switching, and time selection.

Build fully custom date pickers with complete control over layout and styling.

basic-demo

Pre-styled Versions

Choose a pre-styled library to use DatePicker with ready-made designs.
For hook-based usage without components, see the Headless API.

Features#

  • Compound component API with sub-components: Root, Input, Trigger, Value, Clear, ClearTrigger, Portal, Positioner, Arrow, Popup, Panel, Calendar, CalendarContainer, Header, Prev, Next, Title, SelectMonth, SelectYear, Decade, Table, TableHead, TableHeadRow, TableHeadCell, TableHeadWeekCell, TableHeadWeekLabel, TableHeadWeekHeaderLabel, TableBody, TableBodyRow, TableBodyCell, TableBodyWeekCell, TableBodyWeekLabel, Day, Month, Year, Time, Picker, Hour, Minute, Second, AmPm, Increment, Decrement, Separator, Buttonbar, Footer, Today
  • Three calendar views — date, month, and year — with animated navigation between months, years, and decades
  • Single, multiple, and range date selection with keyboard focus cycling
  • Integrated time picker with 12/24 hour format, minute, and second controls

Usage#

import { DatePicker } from 'primereact/datepicker';
<DatePicker.Root>
    <DatePicker.Input />
    <DatePicker.Portal>
        <DatePicker.Positioner>
            <DatePicker.Popup>
                <DatePicker.Arrow />
                <DatePicker.Calendar>
                    <DatePicker.Header>
                        <DatePicker.Prev></DatePicker.Prev>
                        <DatePicker.Title>
                            <DatePicker.SelectMonth />
                            <DatePicker.SelectYear />
                            <DatePicker.Decade />
                        </DatePicker.Title>
                        <DatePicker.Next></DatePicker.Next>
                    </DatePicker.Header>
                    <DatePicker.Table>
                        <DatePicker.TableHead />
                        <DatePicker.TableBody />
                        <DatePicker.TableBody view="month" />
                        <DatePicker.TableBody view="year" />
                    </DatePicker.Table>
                    <DatePicker.Buttonbar>
                        <DatePicker.Today></DatePicker.Today>
                        <DatePicker.ClearTrigger></DatePicker.ClearTrigger>
                    </DatePicker.Buttonbar>
                </DatePicker.Calendar>
                <DatePicker.Time>
                    <DatePicker.Picker type="hour">
                        <DatePicker.Increment></DatePicker.Increment>
                        <DatePicker.Hour />
                        <DatePicker.Decrement></DatePicker.Decrement>
                    </DatePicker.Picker>
                    <DatePicker.Separator />
                    <DatePicker.Picker type="minute">
                        <DatePicker.Increment></DatePicker.Increment>
                        <DatePicker.Minute />
                        <DatePicker.Decrement></DatePicker.Decrement>
                    </DatePicker.Picker>
                </DatePicker.Time>
            </DatePicker.Popup>
        </DatePicker.Positioner>
    </DatePicker.Portal>
</DatePicker.Root>

Behavior#

Motion Animation#

<DatePicker.Popup motionProps={{ name: 'p-datepicker' }}>...</DatePicker.Popup>

See Motion for animation phases, CSS variables, and hide strategies.

Polymorphic Rendering#

Use as on any sub-component to change the rendered HTML element.

<DatePicker.Root as="section">
    <DatePicker.Input as="div" />
    <DatePicker.Prev as="a">...</DatePicker.Prev>
</DatePicker.Root>

Render Function Children#

DatePicker.TableBody, DatePicker.TableHead, and other container components accept a render function as children, providing access to the component instance for custom cell rendering.

<DatePicker.TableBody>
    {(instance) =>
        instance.datepicker?.months[0]?.dates.map((week, weekIndex) => (
            <DatePicker.TableBodyRow key={weekIndex}>
                {week.map((date, dateIndex) => (
                    <DatePicker.TableBodyCell key={dateIndex} date={date}>
                        <DatePicker.Day>{date.day}</DatePicker.Day>
                    </DatePicker.TableBodyCell>
                ))}
            </DatePicker.TableBodyRow>
        ))
    }
</DatePicker.TableBody>

Pass Through#

Some parts may not be visible in the preview depending on the component's current state.

Loading...
/* Select a part to see its CSS selector for custom styling */

API#

DatePickerRoot#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerRootInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerRootInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerRootInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerRootPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerRootInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
valuestring | string[] | Date | Date[]—
Value of the component.
defaultValuestring | string[] | Date | Date[]—
The default value for the input when not controlled by `modelValue` .
openboolean—
Controlled open state of the input tags overlay.
defaultOpenboolean—
Default open state for uncontrolled mode.
namestring—
The name attribute for the element, typically used in form submissions.
selectionMode"multiple" | "range" | "single"single
Defines the quantity of the selection.
dateFormatstring—
Format of the date. Defaults to PrimeVue Locale configuration.
updateModelType"string" | "date"date
Type of the value to write back to modelValue.
selectOtherMonthsbooleanfalse
Whether days in other months shown before or after the current month are selectable. This only applies if the showOtherMonths option is set to true.
showIconbooleanfalse
When enabled, displays a button with icon next to input.
iconstring—
Icon of the datepicker button.
prevIconstring—
Icon to show in the previous button.
nextIconstring—
Icon to show in the next button.
incrementIconstring—
Icon to show in each of the increment buttons.
decrementIconstring—
Icon to show in each of the decrement buttons.
numberOfMonthsnumber1
Number of months to display.
breakpointstring769px
The breakpoint to define the maximum width boundary for datepicker panel.
view"date" | "month" | "year"date
Type of view to display.
minDateDate—
The minimum selectable date.
maxDateDate—
The maximum selectable date.
disabledDatesDate[]—
Array with dates to disable.
disabledDaysnumber[]—
Array with disabled weekday numbers.
maxDateCountnumber—
Maximum number of selectable dates in multiple mode.
showOnFocusbooleantrue
When disabled, datepicker will not be visible with input focus.
autoZIndexbooleantrue
Whether to automatically manage layering.
baseZIndexnumber0
Base zIndex value to use in layering.
showButtonBarbooleanfalse
Whether to display today and clear buttons at the footer.
shortYearCutoffstring+10
The cutoff year for determining the century for a date.
showTimebooleanfalse
Whether to display timepicker.
timeOnlybooleanfalse
Whether to display timepicker only.
hourFormat"12" | "24"24
Specifies hour format.
stepHournumber1
Hours to change per step.
stepMinutenumber1
Minutes to change per step.
stepSecondnumber1
Seconds to change per step.
showSecondsbooleanfalse
Whether to show the seconds in time picker.
showWeekbooleanfalse
Whether to display week numbers.
hideOnDateTimeSelectbooleanfalse
Whether to hide the overlay on date selection when showTime is enabled.
hideOnRangeSelectionbooleanfalse
Whether to hide the overlay on date selection is completed when selectionMode is range.
timeSeparatorstring:
Separator of time selector.
manualInputbooleantrue
Whether to allow entering the date manually via typing.
size"small" | "large"—
Defines the size of the component.
invalidbooleanfalse
When present, it specifies that the component should have invalid state style.
disabledbooleanfalse
When present, it specifies that the component should be disabled.
variant"outlined" | "filled"—
Specifies the input variant of the component.
readOnlybooleanfalse
When present, it specifies that an input field is read-only.
placeholderstring—
Placeholder text for the input.
requiredboolean—
When present, it specifies that the component is a required field.
appendTo"body" | HTMLElement | "self"body
A valid query selector or an HTMLElement to specify where the overlay gets attached.
fluidboolean—
Spans 100% width of the container when enabled.
ariaLabelledbystring—
Establishes relationships between the component and label(s) where its value should be one or more element IDs.
ariaLabelstring—
Establishes a string value that labels the component.
onDateSelect(event: useDatePickerDateSelectEvent) => void—
Callback to invoke when a date is selected.
onMonthChange(event: useDatePickerMonthChangeEvent) => void—
Callback to invoke when the month changes.
onYearChange(event: useDatePickerYearChangeEvent) => void—
Callback to invoke when the year changes.
onTodayButtonClick(event: useDatePickerTodayButtonClickEvent) => void—
Callback to invoke when the today button is clicked.
onClearButtonClick(event: MouseEvent<HTMLButtonElement>) => void—
Callback to invoke when the clear button is clicked.
onInput(event: ChangeEvent<HTMLInputElement>) => void—
Callback to invoke on input event.
onKeyDown(event: KeyboardEvent<HTMLButtonElement | HTMLInputElement>) => void—
Callback to invoke on keydown event.
onFocus(event: FocusEvent<HTMLInputElement>) => void—
Callback to invoke on focus event.
onBlur(event: useDatePickerBlurEvent) => void—
Callback to invoke on blur event.
onOpenChange(event: useDatePickerOpenChangeEvent) => void—
Callback to invoke when the open state changes.
closeOnEscapebooleantrue
Specifies if pressing escape key should hide the overlay.
autoFocusbooleanfalse
Whether to focus the first focusable element when the overlay is opened.
trappedbooleanfalse
When enabled, focus is trapped within the overlay (modal behavior).
onValueChange(event: DatePickerRootValueChangeEvent) => void—
Callback to invoke when the value changes.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"root"
data-disabledPresent when disabled
data-invalidPresent when invalid
data-readonlyPresent when read-only

Defines passthrough(pt) options of DatePicker component.

labeltypedescription
rootDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.
pcInputTextDatePickerRootPassThroughType<HTMLAttributes<HTMLInputElement>>Used to pass attributes to the input's DOM element.
panelDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the panel's DOM element.
calendarContainerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the calendarContainer's DOM element.
calendarDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the calendar's DOM element.
headerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the header's DOM element.
prevDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the prev's DOM element.
titleDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the title's DOM element.
selectMonthDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the selectMonth's DOM element.
selectYearDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the selectYear's DOM element.
decadeDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the decade's DOM element.
nextDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the next's DOM element.
dayViewDatePickerRootPassThroughType<HTMLAttributes<HTMLTableElement>>Used to pass attributes to the dayView's DOM element.
monthViewDatePickerRootPassThroughType<HTMLAttributes<HTMLTableElement>>Used to pass attributes to the monthView's DOM element.
yearViewDatePickerRootPassThroughType<HTMLAttributes<HTMLTableElement>>Used to pass attributes to the yearView's DOM element.
tableHeaderDatePickerRootPassThroughType<HTMLAttributes<HTMLTableSectionElement>>Used to pass attributes to the tableHeader's DOM element.
tableHeaderRowDatePickerRootPassThroughType<HTMLAttributes<HTMLTableRowElement>>Used to pass attributes to the tableHeaderRow's DOM element.
weekDayCellDatePickerRootPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the weekDayCell's DOM element.
weekDayDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the weekDay's DOM element.
weekHeaderDatePickerRootPassThroughType<HTMLAttributes<HTMLTableSectionElement>>Used to pass attributes to the weekHeader's DOM element.
weekHeaderLabelDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the weekHeaderLabel's DOM element.
tableBodyDatePickerRootPassThroughType<HTMLAttributes<HTMLTableSectionElement>>Used to pass attributes to the tableBody's DOM element.
tableBodyRowDatePickerRootPassThroughType<HTMLAttributes<HTMLTableRowElement>>Used to pass attributes to the tableBodyRow's DOM element.
dayCellDatePickerRootPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the dayCell's DOM element.
monthCellDatePickerRootPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the monthCell's DOM element.
yearCellDatePickerRootPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the yearCell's DOM element.
weekNumberDatePickerRootPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the weekNumber's DOM element.
weekLabelDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the weekLabel's DOM element.
buttonbarDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the buttonbar's DOM element.
todayDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the today's DOM element.
clearDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the clear's DOM element.
timePickerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the timePicker's DOM element.
hourPickerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the hourPicker's DOM element.
minutePickerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the minutePicker's DOM element.
secondPickerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the secondPicker's DOM element.
ampmPickerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the ampmPicker's DOM element.
incrementDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the increment's DOM element.
decrementDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the decrement's DOM element.
hourDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the hour's DOM element.
minuteDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the minute's DOM element.
secondDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the second's DOM element.
ampmDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the ampm's DOM element.
separatorDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the separator's DOM element.
clearTriggerDatePickerRootPassThroughType<HTMLAttributes<SVGElement>>Used to pass attributes to the clearTrigger's DOM element.
triggerDatePickerRootPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the trigger's DOM element.
positionerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the positioner's DOM element.
popupDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the popup's DOM element.
arrowDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the arrow's DOM element.
dayDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the day's DOM element.
monthDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the month's DOM element.
yearDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the year's DOM element.
valueDatePickerRootPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the value's DOM element.
footerDatePickerRootPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the footer's DOM element.

DatePickerInput#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerInputInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerInputInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerInputInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerInputPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerInputInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"input"

Defines passthrough(pt) options of DatePickerInput component.

labeltypedescription
rootDatePickerInputPassThroughType<HTMLAttributes<HTMLInputElement>>Used to pass attributes to the root's DOM element.

DatePickerTrigger#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTriggerInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTriggerInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTriggerInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTriggerPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTriggerInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"trigger"

DatePickerValue#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerValueInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerValueInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerValueInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerValuePassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerValueInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
placeholderstring—
Placeholder text to display when no value is selected.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"value"

DatePickerClear#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerClearInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerClearInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerClearInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerClearPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerClearInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"clear"

Defines passthrough(pt) options of DatePickerClear component.

labeltypedescription
rootDatePickerClearPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerClearTrigger#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerClearTriggerInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerClearTriggerInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerClearTriggerInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerClearTriggerPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerClearTriggerInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"clear-trigger"

Defines passthrough(pt) options of DatePickerClearTrigger component.

labeltypedescription
rootDatePickerClearTriggerPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the root's DOM element.

DatePickerPortal#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
style(CSSProperties | ((instance?: PortalInstance) => CSSProperties)) & (CSSProperties | ((instance?: DatePickerPortalInstance) => CSSProperties))—
The style to apply to the component.
className(string | ((instance?: PortalInstance) => string)) & (string | ((instance?: DatePickerPortalInstance) => string))—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceBaseInstance<SafeRecord<PortalProps>, unknown, HTMLElement> & { props: SafeRecord<SafeRecord<PortalProps>>; attrs: Omit<SafeRecord<SafeRecord<PortalProps>>, string | number | symbol> & Record<PropertyKey, unknown> } & { state: SafeRecord; $computedSetup: SafeRecord } & PortalExposes & Record<PropertyKey, unknown> & useComponentPTReturnType & useComponentStyleReturnType & BaseInstance<SafeRecord<DatePickerPortalProps>, unknown, HTMLElement> & { props: SafeRecord<SafeRecord<DatePickerPortalProps>>; attrs: Omit<SafeRecord<SafeRecord<DatePickerPortalProps>>, string | number | symbol> & Record<PropertyKey, unknown> } & { state: SafeRecord; $computedSetup: SafeRecord } & DatePickerPortalExposes—
The instance to pass to the component.
ptPortalPassThrough & Record<PropertyKey, unknown> & DatePickerPortalPassThrough—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: PortalInstance) => ReactNode & (instance: DatePickerPortalInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
onMounted() => void—
Callback function to invoke when the portal is mounted.
onUnmounted() => void—
Callback function to invoke when the portal is unmounted.
elementHTMLElement | ReactNode—
The element to be rendered as the portal.
elementRefRefObject<HTMLElement>—
The element reference to be rendered as the portal.
appendTostring | HTMLElement | ((instance: PortalInstance) => HTMLElement)'body'
The DOM element where the portal should be appended to.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"portal"

Defines passthrough(pt) options of DatePickerPortal component.

labeltypedescription
rootDatePickerPortalPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerPositioner#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerPositionerInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerPositionerInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerPositionerInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerPositionerPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerPositionerInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
sideSideType—
The side of the positioner.
alignAlignType—
The align of the positioner.
sideOffsetnumber—
The side offset of the positioner.
alignOffsetnumber—
The align offset of the positioner.
flipboolean—
Whether to flip the positioner.
shiftboolean—
Whether to shift the positioner.
hideWhenDetachedboolean—
Whether to hide the positioner when detached.
strategy"fixed" | "absolute"'fixed'
The positioning strategy.
boundaryHTMLElement—
The boundary element that constrains the positioner placement. Used in JS fallback mode only; CSS Anchor mode uses the containing block.
anchorHTMLElement—
The anchor element.
contentHTMLDivElement—
The content element.
arrowHTMLDivElement—
The arrow element.
autoZIndexbooleantrue
Whether to automatically manage layering.
baseZIndexnumber0
Base zIndex value to use in layering.
onPlacementChange(placement: { side: SideType; align: AlignType }) => void—
Callback invoked when the actual placement changes due to flip or shift.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"positioner"
data-side"top" | "bottom" | "left" | "right" — placement
data-align"start" | "center" | "end" — alignment

CSS Custom Properties

The positioner element exposes CSS custom properties for layout and transform control.

CSS VariableDescription
--available-heightAvailable vertical space in pixels
--available-widthAvailable horizontal space in pixels
--transform-originComputed transform origin for animations
--positioner-anchor-widthWidth of the anchor/trigger element

DatePickerPopup#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerPopupInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerPopupInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerPopupInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerPopupPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerPopupInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"popup"
data-openPresent when popup is open

DatePickerArrow#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerArrowInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerArrowInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerArrowInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerArrowPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerArrowInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"arrow"
data-side"top" | "bottom" | "left" | "right" — placement
data-align"start" | "center" | "end" — alignment

CSS Custom Properties

The arrow element exposes CSS custom properties for dynamic positioning:

CSS VariableDescription
--placer-arrow-xHorizontal offset of arrow
--placer-arrow-yVertical offset of arrow
--placer-arrow-leftLeft position of arrow element
--placer-arrow-topTop position of arrow element

DatePickerPanel#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerPanelInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerPanelInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerPanelInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerPanelPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerPanelInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"panel"

Defines passthrough(pt) options of DatePickerPanel component.

labeltypedescription
rootDatePickerPanelPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerCalendar#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerCalendarInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerCalendarInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerCalendarInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerCalendarPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerCalendarInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"calendar"

Defines passthrough(pt) options of DatePickerCalendar component.

labeltypedescription
rootDatePickerCalendarPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerCalendarContainer#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerCalendarContainerInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerCalendarContainerInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerCalendarContainerInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerCalendarContainerPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerCalendarContainerInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"calendarContainer"

DatePickerHeader#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerHeaderInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerHeaderInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerHeaderInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerHeaderPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerHeaderInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"header"

Defines passthrough(pt) options of DatePickerHeader component.

labeltypedescription
rootDatePickerHeaderPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerPrev#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerPrevInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerPrevInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerPrevInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerPrevPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerPrevInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"prev"

Defines passthrough(pt) options of DatePickerPrev component.

labeltypedescription
rootDatePickerPrevPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerNext#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerNextInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerNextInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerNextInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerNextPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerNextInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"next"

Defines passthrough(pt) options of DatePickerNext component.

labeltypedescription
rootDatePickerNextPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerTitle#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTitleInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTitleInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTitleInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTitlePassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTitleInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"title"

Defines passthrough(pt) options of DatePickerTitle component.

labeltypedescription
rootDatePickerTitlePassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerSelectMonth#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerSelectMonthInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerSelectMonthInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerSelectMonthInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerSelectMonthPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerSelectMonthInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"select-month"

Defines passthrough(pt) options of DatePickerSelectMonth component.

labeltypedescription
rootDatePickerSelectMonthPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerSelectYear#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerSelectYearInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerSelectYearInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerSelectYearInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerSelectYearPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerSelectYearInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"select-year"

Defines passthrough(pt) options of DatePickerSelectYear component.

labeltypedescription
rootDatePickerSelectYearPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerDecade#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerDecadeInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerDecadeInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerDecadeInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerDecadePassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerDecadeInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"decade"

Defines passthrough(pt) options of DatePickerDecade component.

labeltypedescription
rootDatePickerDecadePassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the root's DOM element.

DatePickerTable#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTablePassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"table"

Defines passthrough(pt) options of DatePickerTable component.

labeltypedescription
rootDatePickerTablePassThroughType<HTMLAttributes<HTMLTableElement>>Used to pass attributes to the root's DOM element.

DatePickerTableHead#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableHeadInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableHeadInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableHeadInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableHeadPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableHeadInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"tableHeader"

Defines passthrough(pt) options of DatePickerTableHead component.

labeltypedescription
rootDatePickerTableHeadPassThroughType<HTMLAttributes<HTMLTableSectionElement>>Used to pass attributes to the root's DOM element.

DatePickerTableHeadRow#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableHeadRowInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableHeadRowInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableHeadRowInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableHeadRowPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableHeadRowInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"tableHeaderRow"

Defines passthrough(pt) options of DatePickerTableHeadRow component.

labeltypedescription
rootDatePickerTableHeadRowPassThroughType<HTMLAttributes<HTMLTableRowElement>>Used to pass attributes to the root's DOM element.

DatePickerTableHeadCell#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableHeadCellInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableHeadCellInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableHeadCellInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableHeadCellPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableHeadCellInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"weekDayCell"

Defines passthrough(pt) options of DatePickerTableHeadCell component.

labeltypedescription
rootDatePickerTableHeadCellPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the root's DOM element.

DatePickerTableHeadWeekCell#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableHeadWeekCellInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableHeadWeekCellInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableHeadWeekCellInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableHeadWeekCellPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableHeadWeekCellInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"weekHeader"

Defines passthrough(pt) options of DatePickerTableHeadWeekCell component.

labeltypedescription
rootDatePickerTableHeadWeekCellPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the root's DOM element.

DatePickerTableHeadWeekLabel#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableHeadWeekLabelInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableHeadWeekLabelInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableHeadWeekLabelInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableHeadWeekLabelPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableHeadWeekLabelInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"weekDay"

DatePickerTableHeadWeekHeaderLabel#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableHeadWeekHeaderLabelInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableHeadWeekHeaderLabelInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableHeadWeekHeaderLabelInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableHeadWeekHeaderLabelPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableHeadWeekHeaderLabelInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"weekHeaderLabel"

DatePickerTableBody#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableBodyInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableBodyInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableBodyInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableBodyPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableBodyInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
view"date" | "month" | "year"date
Current view of the date picker.
indexnumber0
Index of the table body.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"tableBody"

Defines passthrough(pt) options of DatePickerTableBody component.

labeltypedescription
rootDatePickerTableBodyPassThroughType<HTMLAttributes<HTMLTableSectionElement>>Used to pass attributes to the root's DOM element.

DatePickerTableBodyRow#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableBodyRowInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableBodyRowInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableBodyRowInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableBodyRowPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableBodyRowInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"tableBodyRow"

Defines passthrough(pt) options of DatePickerTableBodyRow component.

labeltypedescription
rootDatePickerTableBodyRowPassThroughType<HTMLAttributes<HTMLTableRowElement>>Used to pass attributes to the root's DOM element.

DatePickerTableBodyCell#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableBodyCellInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableBodyCellInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableBodyCellInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableBodyCellPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableBodyCellInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
dateuseDatePickerDateMeta—
Date metadata for the cell.
monthuseDatePickerMonthOptions—
Month options for the cell.
indexnumber—
Month index of the cell.
yearuseDatePickerYearOptions—
Year options for the cell.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"cell"

Defines passthrough(pt) options of DatePickerTableBodyCell component.

labeltypedescription
rootDatePickerTableBodyCellPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the root's DOM element.

DatePickerTableBodyWeekCell#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableBodyWeekCellInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableBodyWeekCellInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableBodyWeekCellInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableBodyWeekCellPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableBodyWeekCellInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"weekNumber"

Defines passthrough(pt) options of DatePickerTableBodyWeekCell component.

labeltypedescription
rootDatePickerTableBodyWeekCellPassThroughType<HTMLAttributes<HTMLTableCellElement>>Used to pass attributes to the root's DOM element.

DatePickerTableBodyWeekLabel#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTableBodyWeekLabelInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTableBodyWeekLabelInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTableBodyWeekLabelInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTableBodyWeekLabelPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTableBodyWeekLabelInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"weekLabel"

DatePickerDay#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerDayInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerDayInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerDayInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerDayPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerDayInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
dayuseDatePickerDateMeta—
Date metadata for the day.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"day"
data-selected"true" when selected
data-disabled"true" when disabled
data-today"true" on today's date
data-other-month"true" for adjacent months

DatePickerMonth#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerMonthInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerMonthInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerMonthInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerMonthPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerMonthInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
monthuseDatePickerMonthOptions—
Month options for the cell.
indexnumber—
Month index of the cell.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"month"
data-selected"true" when selected
data-disabled"true" when disabled

DatePickerYear#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerYearInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerYearInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerYearInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerYearPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerYearInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
yearuseDatePickerYearOptions—
Year options for the cell.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"year"
data-selected"true" when selected
data-disabled"true" when disabled

DatePickerTime#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTimeInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTimeInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTimeInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTimePassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTimeInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"timePicker"

Defines passthrough(pt) options of DatePickerTime component.

labeltypedescription
rootDatePickerTimePassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerPicker#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerPickerInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerPickerInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerPickerInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerPickerPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerPickerInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
type"ampm" | "hour" | "minute" | "second"—
Type of the picker.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"hourPicker" | "minutePicker" | "secondPicker" | "ampmPicker"

Defines passthrough(pt) options of DatePickerPicker component.

labeltypedescription
rootDatePickerPickerPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerHour#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerHourInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerHourInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerHourInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerHourPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerHourInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"hour"

Defines passthrough(pt) options of DatePickerHour component.

labeltypedescription
rootDatePickerHourPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the root's DOM element.

DatePickerMinute#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerMinuteInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerMinuteInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerMinuteInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerMinutePassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerMinuteInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"minute"

Defines passthrough(pt) options of DatePickerMinute component.

labeltypedescription
rootDatePickerMinutePassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the root's DOM element.

DatePickerSecond#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerSecondInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerSecondInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerSecondInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerSecondPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerSecondInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"second"

Defines passthrough(pt) options of DatePickerSecond component.

labeltypedescription
rootDatePickerSecondPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the root's DOM element.

DatePickerAmPm#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerAmPmInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerAmPmInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerAmPmInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerAmPmPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerAmPmInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"ampm"

Defines passthrough(pt) options of DatePickerAmPm component.

labeltypedescription
rootDatePickerAmPmPassThroughType<HTMLAttributes<HTMLSpanElement>>Used to pass attributes to the root's DOM element.

DatePickerIncrement#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerIncrementInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerIncrementInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerIncrementInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerIncrementPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerIncrementInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"increment"

Defines passthrough(pt) options of DatePickerIncrement component.

labeltypedescription
rootDatePickerIncrementPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerDecrement#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerDecrementInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerDecrementInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerDecrementInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerDecrementPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerDecrementInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"decrement"

Defines passthrough(pt) options of DatePickerDecrement component.

labeltypedescription
rootDatePickerDecrementPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerSeparator#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerSeparatorInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerSeparatorInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerSeparatorInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerSeparatorPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerSeparatorInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"separator"

DatePickerButtonbar#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerButtonbarInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerButtonbarInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerButtonbarInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerButtonbarPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerButtonbarInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"buttonbar"

Defines passthrough(pt) options of DatePickerButtonbar component.

labeltypedescription
rootDatePickerButtonbarPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerFooter#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerFooterInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerFooterInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerFooterInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerFooterPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerFooterInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"footer"

Defines passthrough(pt) options of DatePickerFooter component.

labeltypedescription
rootDatePickerFooterPassThroughType<HTMLAttributes<HTMLDivElement>>Used to pass attributes to the root's DOM element.

DatePickerToday#

NameTypeDefault
refRef<unknown>—
The reference to the component instance.
pIfbooleantrue
Whether the component should be rendered.
styleCSSProperties | ((instance?: DatePickerTodayInstance) => CSSProperties)—
The style to apply to the component.
classNamestring | ((instance?: DatePickerTodayInstance) => string)—
The class name to apply to the component.
asstring | number | bigint | boolean | ComponentClass<any, any> | FunctionComponent<any> | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode, any, any> | ReactPortal | Promise<AwaitedReactNode>—
The component type to render.
asChildbooleanfalse
Whether the component should be rendered as a child component.
instanceDatePickerTodayInstance—
The instance to pass to the component.
ptSafeRecord<DatePickerTodayPassThrough>—
The pass-through props to pass to the component.
ptOptionsPassThroughOptions—
The pass-through options to pass to the component.
unstyledboolean—
Whether the component should be rendered without classes.
dtunknown—
The design token to use for the component.
stylesStylesOptions<ComponentInstance>—
The styles to use for the component.
render(instance: DatePickerTodayInstance) => ReactNode—
The render function to render the component with instance access.
childrenany—
The children to render. Accepts `React.ReactNode` for static content or a render function `(instance: I) => React.ReactNode` for instance access. Typed as `any` to avoid JSX type errors when used directly in templates.
[key: string]any—
pt-{optionName}-*-—
Pass through attributes for customizing component. For more info, see Pass Through tab.
AttributeValue
data-scope"datepicker"
data-part"today"

Defines passthrough(pt) options of DatePickerToday component.

labeltypedescription
rootDatePickerTodayPassThroughType<HTMLAttributes<HTMLButtonElement>>Used to pass attributes to the root's DOM element.

DatePickerDropdown#

Accessibility#

Screen Reader#

Value to describe the component can either be provided via label tag combined with inputId prop or using aria-labelledby, aria-label props. The input element has combobox role in addition to aria-autocomplete as "none", aria-haspopup as "dialog" and aria-expanded attributes. The relation between the input and the popup is created with aria-controls attribute that refers to the id of the popup.

The optional datepicker button requires includes aria-haspopup, aria-expanded for states along with aria-controls to define the relation between the popup and the button.

Popup has a dialog role along with aria-modal and aria-label. The navigation buttons at the header have an aria-label retrieved from the locale aria API. Similarly month picker button uses the chooseMonth and year picker button uses the chooseYear keys.

Main date table uses grid role that contains th elements with col as the scope along with abbr tag resolving to the full name of the month. Each date cell has an aria-label referring to the full date value. Buttons at the footer utilize their readable labels as aria-label as well. Selected date also receives the aria-selected attribute.

Timepicker spinner buttons get their labels for aria-label from the aria locale API using the prevHour, nextHour, prevMinute, nextMinute, prevSecond, nextSecond, am and pm keys.

DatePicker also includes a hidden section that is only available to screen readers with aria-live as "polite". This element is updated when the selected date changes to instruct the user about the current date selected.

Choose Date Button Keyboard Support#

KeyFunction
spaceOpens popup and moves focus to the selected date, if there is none focuses on today.
enterOpens popup and moves focus to the selected date, if there is none focuses on today.
KeyFunction
escapeCloses the popup and moves focus to the input element.
tabMoves focus to the next focusable element within the popup.
shift + tabMoves focus to the next focusable element within the popup.

Header Buttons Keyboard Support#

KeyFunction
enterTriggers the button action.
spaceTriggers the button action.

Date Grid Keyboard Support#

KeyFunction
enterSelects the date, closes the popup and moves focus to the input element.
spaceCloses the popup and moves focus to the input element.
up arrowMoves focus to the same day of the previous week.
alt + up arrowCloses the popup and moves focus to the input element.
down arrowMoves focus to the same day of the next week.
right arrowMoves focus to the next day.
left arrowMoves focus to the previous day.
homeMoves focus to the first day of the current week.
endMoves focus to the last day of the current week.
page upChanges the date to previous month in date picker mode. Moves to previous year in month picker mode and previous decade in year picker.
shift + page upChanges the date to previous year in date picker mode. Has no effect in month or year picker.
page downChanges the date to next month in date picker mode. Moves to next year in month picker mode and next decade in year picker.
shift + page downChanges the date to next year in date picker mode. Has no effect in month or year picker.
KeyFunction
enterTriggers the button action.
spaceTriggers the button action.