Ready

Calendar

The Calendar allows users to visually select a date from a calendar grid for quick and accurate date selection.

Ready

Calendar

The Calendar allows users to visually select a date from a calendar grid for quick and accurate date selection.

Ready

Calendar

The Calendar allows users to visually select a date from a calendar grid for quick and accurate date selection.

Anatomy

Anatomy

Anatomy

  1. Calendar Slider

  2. Presets

  3. Buttons

Variants

Variants

Variants

  1. Default

  2. Range

  3. With Presets

States

States

States

  1. Default

  2. Hover

  3. Selected

  4. Disabled

  5. Today

  6. Today: Hover

  7. Today: Selected

  8. Focus Visible

  9. Range: Start

  10. Range: Middle

  11. Range: End

Behaviors

Behaviors

Behaviors

Month & Year Selectors

Month and year selectors allow users to navigate or select across large date ranges more easily.

  1. Month Select

  2. Year Select

Slide Animation

The calendar uses a --anim-ease-in-out --anim-duration-md animation to help users better understand the direction of movements within the calendar.

Best Practices

Best Practices

Best Practices

1. Positioning

Ensure that the calendar component is visible and is not being cut off by the side of the browser window or by the viewport of smaller breakpoints.

2. Range with Presets

Use the Calendar with presets variant to provide a list of common date ranges. This list should be short and should not include unnecessary options that will confuse the user. ¹

3. Unavailable days

Use the calendar day button disable states to display unavailable days. Do not hide them from within the calendar.¹

More

More

More

Related Components

Accessibility

Color contrast ratio for our Calendar component meets AAA standards, based on Web Content Accessibility Guidelines (WCAG) guidelines.

  1. Benefits: People with low vision often have difficulty reading text that does not contrast with its background. This can be exacerbated if the person has a color vision deficiency that lowers the contrast even further. Providing a minimum luminance contrast ratio between the text and its background can make the text more readable even if the person does not see the full range of colors. It also works for the rare individuals who see no color.

Additional Reading

  1. The Ultimate Guide to Design a Perfect Date Picker https://uxdworld.com/2019/03/02/how-to-design-a-perfect-date-picker/

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

© 2025 Basis Technologies
© 2025 Basis Technologies
© 2025 Basis Technologies