generated:catalog.entry.datepicker.title
generated:catalog.entry.datepicker.description
@xngui/components/datepicker@xngui/components/datepickerchrome:demo.section
chrome:demo.preview
import { Component } from '@angular/core';
import { XDatepicker } from '@xngui/components/datepicker';
import { XForm } from '@xngui/components/form';
import { XFormField } from '@xngui/components/form-field';
@Component({
selector: 'app-example',
imports: [XDatepicker, XForm, XFormField],
templateUrl: './datepicker.component.html',
})
export class ExampleComponent {}
chrome:demo.events.title
chrome:demo.events.empty
chrome:demo.api.title
x-datepicker
chrome:demo.api.col.property
chrome:demo.api.col.type
chrome:demo.api.col.default
chrome:demo.api.col.description
modeXDatepickerMode'date'Picker granularity — date only, date + time, or time only.
selectionModeXCalendarMode'single'Calendar selection mode — single day or date range.
calendarXCalendarSystem'gregory'Intl calendar identifier for the embedded XCalendar.
sizeXSize—Visual size tier — falls back to XConfigService when unset.
densityXDensity—Spacing offsets — orthogonal to `size`; falls back to XConfigService when unset.
placeholderstring—Placeholder in the typable field — defaults to the mask pattern for `mode` and `dateFormat` when unset.
lookXFormLook—Field chrome — outline, fill, flat, or none; falls back to XForm then XConfigService.
localestring—BCP 47 locale for formatting the displayed value — falls back to XLocaleService when unset.
dateFormatXDatepickerTextFormatInput'auto'Masked typing layout — `us`, `iso`, or `auto` from `locale`.
minDate—Earliest selectable date — forwarded to the embedded XCalendar.
maxDate—Latest selectable date — forwarded to the embedded XCalendar.
firstDayOfWeeknumber—First day of the week in the embedded calendar (`0` = Sunday) — falls back to the resolved locale when unset.
dateFilterXCalendarDateFilter—Predicate forwarded to the embedded XCalendar — returns `false` for disabled dates.
ariaLabelstring—Accessible name for the embedded calendar grid.
prevMonthLabelstring—Accessible label for the previous-month control in the embedded calendar.
nextMonthLabelstring—Accessible label for the next-month control in the embedded calendar.
prevYearLabelstring—Accessible label for the previous-year control in the embedded calendar month view.
nextYearLabelstring—Accessible label for the next-year control in the embedded calendar month view.
prevYearsLabelstring—Accessible label for the previous-year-page control in the embedded calendar year view.
nextYearsLabelstring—Accessible label for the next-year-page control in the embedded calendar year view.
chooseMonthLabelstring—Accessible label for the month-picker header button in the embedded calendar.
chooseYearLabelstring—Accessible label for the year-picker header button in the embedded calendar.
minuteStepnumber1Minute increment in the time picker.
openLabelstring—Accessible label for the open trigger.
closeLabelstring—Accessible label for the close trigger.
hourLabelstring—Accessible label for the hour column in the time picker.
minuteLabelstring—Accessible label for the minute column in the time picker.
applyLabelstring—Accessible label for the apply-time action.
nowLabelstring—Accessible label for the set-to-now action.
timeHeadingLabelstring—Heading above the time controls in datetime mode.
dateTabLabelstring—Tab label for the date panel in datetime mode.
timeTabLabelstring—Tab label for the time panel in datetime mode.
dateTimeTabsLabelstring—Accessible name for the date/time tab list in datetime mode.
disabledbooleanfalsePrevents interaction and sets `aria-disabled` on the field.
readonlybooleanfalseValue-only input — user cannot change when true.
invalidbooleanfalseMarks the control invalid for styling and ARIA.
requiredbooleanfalseMarks the control as required for validation and ARIA.
namestring''Native form control `name` attribute.
controlIdstring—Native `id` on the inner input; falls back to `name`, then a generated id.