The d2l-calendar component can be used to display a responsively sized calendar that allows for date selection. It indicates the currently selected date if selected-value is specified, or if the user selects a date.
<script type="module">
import '@brightspace-ui/core/components/calendar/calendar.js';
</script>
<d2l-calendar selected-value="2020-05-09" summary="Click on a day to select it.">
</d2l-calendar>Note: All *-value properties should be in ISO 8601 calendar date format (YYYY-MM-DD) and should be localized to the user's time zone (if applicable).
| Property | Type | Description |
|---|---|---|
max-value |
String | Maximum valid date that could be selected by a user. |
min-value |
String | Minimum valid date that could be selected by a user. |
selected-value |
String | Currently selected date. |
summary |
String | ACCESSIBILITY: Summary of the calendar used by screen reader users for identifying the calendar and/or summarizing its purpose. |
d2l-calendar-selected: dispatched when a date is selected through click, space, or enter.e.detail.dateis in ISO 8601 calendar date format (YYYY-MM-DD).
getShownYearAndMonth(): returns an object containing the year and month in view.
The Daylight calendar (d2l-calendar) generally follows the W3C's best practice recommendations for a Date picker dialog. Of note is the keyboard behaviour following the grid pattern.
The W3C recommendations, specifically relating to attributes on the calendar's table elements, were followed as much as possible. At the time of development it was not possible to create a calendar with a grid role which had the desired appearance, functionality, and supported all browser/screen reader combinations that we support; the expected screen reader experience was replicated as much as possible (e.g., announcing the expected content).