A single-date calendar around your native text input. The input owns labels, validation, reset and form submission; the modal calendar drafts a date until Apply. Use cem-field for general text and cem-autocomplete for suggested values.
Full examples and variation matrix · Property playground · Automated stories
Use YYYY-MM-DD. ArrowDown opens the calendar. Arrows, Home/End and PageUp/PageDown navigate; Shift or Alt with PageUp/PageDown changes year. Enter or Space drafts a date. Apply commits, and Cancel or Escape restores focus without changing the input.
{slice @name=min | 2026-01-01}
{cem-field @label="min" @value="{$datadom.slices.min}" @slice=min @slice-event=input @slice-value="$target.value"}
{slice @name=max | 2027-12-31}
{cem-field @label="max" @value="{$datadom.slices.max}" @slice=max @slice-event=input @slice-value="$target.value"}
{slice @name=lang | en-US}
{cem-field @label="lang" @value="{$datadom.slices.lang}" @slice=lang @slice-event=input @slice-value="$target.value"}
{slice @name=label | Arrival date}
{cem-field @label="label" @value="{$datadom.slices.label}" @slice=label @slice-event=input @slice-value="$target.value"}
{slice @name=value | 2026-08-11}
{cem-field @label="value" @value="{$datadom.slices.value}" @slice=value @slice-event=input @slice-value="$target.value"}
{slice @name=name | arrival}
{cem-field @label="name" @value="{$datadom.slices.name}" @slice=name @slice-event=input @slice-value="$target.value"}
{slice @name=form | }
{cem-field @label="form" @value="{$datadom.slices.form}" @slice=form @slice-event=input @slice-value="$target.value"}
{slice @name=class | }
{cem-field @label="class" @value="{$datadom.slices.class}" @slice=class @slice-event=input @slice-value="$target.value"}
{slice @name=indicator | underline}
{fieldset @role=group @aria-label="indicator" @slice=indicator @slice-event=change @slice-value="$target.value" | {legend | indicator}{cem-radio @name="property-indicator" @value="underline" @label="underline" @checked={if datadom.slices.indicator == "underline" {true} else {null}}}{cem-radio @name="property-indicator" @value="outline" @label="outline" @checked={if datadom.slices.indicator == "outline" {true} else {null}}}}
{slice @name=dir | ltr}
{fieldset @role=group @aria-label="dir" @slice=dir @slice-event=change @slice-value="$target.value" | {legend | dir}{cem-radio @name="property-dir" @value="ltr" @label="ltr" @checked={if datadom.slices.dir == "ltr" {true} else {null}}}{cem-radio @name="property-dir" @value="rtl" @label="rtl" @checked={if datadom.slices.dir == "rtl" {true} else {null}}}}
{slice @name=disabled | absent}
{fieldset @role=group @aria-label="disabled" @slice=disabled @slice-event=change @slice-value="$target.value" | {legend | disabled}{cem-radio @name="property-disabled" @value="absent" @label="absent" @checked={if datadom.slices.disabled == "absent" {true} else {null}}}{cem-radio @name="property-disabled" @value="present" @label="present" @checked={if datadom.slices.disabled == "present" {true} else {null}}}}
{slice @name=required | absent}
{fieldset @role=group @aria-label="required" @slice=required @slice-event=change @slice-value="$target.value" | {legend | required}{cem-radio @name="property-required" @value="absent" @label="absent" @checked={if datadom.slices.required == "absent" {true} else {null}}}{cem-radio @name="property-required" @value="present" @label="present" @checked={if datadom.slices.required == "present" {true} else {null}}}}
{slice @name=invalid | absent}
{fieldset @role=group @aria-label="invalid" @slice=invalid @slice-event=change @slice-value="$target.value" | {legend | invalid}{cem-radio @name="property-invalid" @value="absent" @label="absent" @checked={if datadom.slices.invalid == "absent" {true} else {null}}}{cem-radio @name="property-invalid" @value="present" @label="present" @checked={if datadom.slices.invalid == "present" {true} else {null}}}}
{slice @name=hidden | absent}
{fieldset @role=group @aria-label="hidden" @slice=hidden @slice-event=change @slice-value="$target.value" | {legend | hidden}{cem-radio @name="property-hidden" @value="absent" @label="absent" @checked={if datadom.slices.hidden == "absent" {true} else {null}}}{cem-radio @name="property-hidden" @value="present" @label="present" @checked={if datadom.slices.hidden == "present" {true} else {null}}}}
{form | {cem-datepicker @class="{$datadom.slices.class}" @min="{$datadom.slices.min}" @max="{$datadom.slices.max}" @lang="{$datadom.slices.lang}" @indicator="{$datadom.slices.indicator}" @dir="{$datadom.slices.dir}" @disabled={if datadom.slices.disabled == "present" {true} else {null}} @required={if datadom.slices.required == "present" {true} else {null}} @invalid={if datadom.slices.invalid == "present" {true} else {null}} @hidden={if datadom.slices.hidden == "present" {true} else {null}} |
{input @slot=input @type=text @aria-label="{$datadom.slices.label}" @name="{$datadom.slices.name}" @form={if datadom.slices.form {datadom.slices.form} else {null}} | {attribute @name=value @value={datadom.slices.value}}}
{button @slot=toggle @type=button @aria-label="Choose date" | Choose}
}{cem-action @type=reset @label="Reset date"}}
{cem-module-url @slice=sourceUrl @src="@epa-wg/cem-components/components/cem-datepicker/cem-datepicker.xhtml"}{cem:if @test="datadom.slices.sourceUrl" | {p | {a @href="{$datadom.slices.sourceUrl}" | Open canonical XHTML}}{cem-demo-element @legend="Canonical source" @src="{$datadom.slices.sourceUrl}" @type=xml @demo=false}}