Date Picker
A date picker is a control for typing or choosing a day on a calendar. It does not choose a time of day.
A real example
A traveler can choose a date from August 4 onward, while some days are unavailable. Keyboard or pointer input returns 2026-08-12 and explains the limits. If typing a known ISO date is faster, the calendar must not be required.
Main parts
- 01date field
- 02calendar grid
- 03minimum and unavailable dates
Use it when
Use this term when the task needs a valid date and seeing a calendar helps the user.
Do not use it when
Do not use a complex calendar when asking only for a month, year, length of time, or rough date.
Name used in code
<input type=date> or accessible calendar dialog Before you ship
Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery.
Outcome: Use Date Picker to solve this user need without losing the current context. User context: A traveler can choose a date from August 4 onward, while some days are unavailable. Keyboard or pointer input returns 2026-08-12 and explains the limits. If typing a known ISO date is faster, the calendar must not be required. Recommended pattern: Date Picker. Why it fits: Use this term when the task needs a valid date and seeing a calendar helps the user. Do not use it when: Do not use a complex calendar when asking only for a month, year, length of time, or rough date. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Date Picker. Definition: A date picker is a control for typing or choosing a day on a calendar. It does not choose a time of day. Release checks: Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.