All components

INPUTS / COMPONENTS

Date picker

Choose a date in context.

Live component21 documented props

About date picker

Date Picker is a helpful to visualize what days are available to select for the user.

01

Anatomy

Shared parts, named consistently.

  1. 1
    Date Picker FieldContainerRequired

    The main container

  2. 2
    Date Picker FieldLabelRequired

    The label of the field.

  3. 3
    Date Picker FieldAsterix

    A star to show when required.

  4. 4
    Date Picker FieldSelected dateRequired

    A text string to show what date has been selected.

  5. 5
    Date Picker FieldIcon ButtonRequired

    An Icon Button will render to clear the input.

  6. 6
    Date Picker Fieldcalendar iconRequired

    A decorative icon to enhance the input.

  7. 7
    Date Picker FieldHelper message

    A string below the input to provide additional context about the Dropdown. When in an error state, the helper message will turn red.

  8. 1
    Date Picker calendarContainerRequired

    The container of the picker.

  9. 2
    Date Picker calendarHeaderRequired

    The header that contains the controls.

  10. 3
    Date Picker calendarTitlesRequired

    The titles of the columns.

  11. 4
    Date Picker calendarDay buttonRequired

    A button to select that day.

  12. 5
    Date Picker calendarHighlight

    An icon to indicate significant day(s).

  13. 6
    Date Picker calendarToday indicatorRequired

    An indicator to show the current day.

  14. 7
    Date Picker calendarFooterRequired

    The footer that contains the legend

Try the default

A working example with the shared V1 visual language.

When to use

Use for choosing a calendar date. Explain unavailable dates and display the selected date unambiguously.

Type a date or use Alt+Down to open the calendar. Arrow keys move between dates, Page Up/Down changes month, and Enter selects. Escape closes without applying a draft range.

Related components

Source & adaptation

V1 semantic colors, DM Sans typography, compact controls, and responsive layouts. The API table describes this implementation; source design notes may use earlier API terminology.

components/library/date-picker.tsx