Vivid Logo Vivid

Date Range Picker

Combines an Input and a dual Calendar popover to allow users to enter or select a date range.

Labelling

Label Text

The label attribute provides a short description of the purpose of the Date Picker.

If a visible label can't be used, provide one using the aria-label attribute. This ensures screen readers announce the purpose of the element, making it accessible to all users.

Helper Text

The helper-text attribute provides additional information to help the user enter the correct information.

To add HTML to the helper text, use the helper-text slot.

Validation Feedback

Error Text

The error-text attribute provides a custom error message. Any current error state will be overridden by error-text.

Start and End Values

Use the start and end attributes to define the date range. If either attribute is set to an empty string or undefined, no date is selected.

When a date is chosen, these attributes always contain a valid date in the YYYY-MM-DD format. If the user enters an invalid date, an error message is displayed.

Min

Set the min attribute to configure the earliest date to accept. The user will be prevented from choosing an earlier date, however it is still possible to manually enter one.

Max

Set the max attribute to configure the latest date to accept. The user will be prevented from choosing an later date, however it is still possible to manually enter one.

Disabled

Add the disabled attribute to disable the Date Range Picker.

Readonly

Add the readonly attribute to make the Date Range Picker readonly.