# Calendar > Date selection calendar component Source: https://shellui.dev/docs/v0.3/components/advanced/calendar The Calendar component provides a visual calendar interface for selecting dates with support for single date, date ranges, and multiple date selections. ## Installation ```bash shellui add calendar ``` > **Code only** > > These examples are shown as code because this site runs ShellUI 0.4, where the `SelectedDateChanged` callback type changed. For live previews, see the [v0.4 Calendar page](https://shellui.dev/docs/v0.4/components/advanced/calendar.md). ## Basic Usage ```razor @code { private DateTime? selectedDate; private void HandleDateChanged(DateTime date) { selectedDate = date; } } ``` ## Single Date Selection ```razor @code { private DateTime? date = DateTime.Today; private void HandleDateChanged(DateTime date) { this.date = date; } } ``` Or with two-way binding: ```razor @code { private DateTime date = DateTime.Today; } ``` > **Bind to a non-nullable DateTime** > > In 0.3.x, `SelectedDate` is `DateTime?` but `SelectedDateChanged` is `EventCallback`, so `@bind-SelectedDate` only compiles against a `DateTime` field. Use `SelectedDate` + `SelectedDateChanged` explicitly if you need a nullable value. ## With Date Picker Combine calendar with a date picker input: ```razor @if (showCalendar) {
} @code { private bool showCalendar = false; private DateTime? selectedDate; private void HandleDateChanged(DateTime date) { selectedDate = date; showCalendar = false; } } ``` ## Date Range Restrictions Restrict selectable date ranges: ```razor @code { private DateTime? date; private void HandleDateChanged(DateTime date) { this.date = date; } } ``` ## API Reference | Property | Type | Default | Description | |----------|------|---------|-------------| | `SelectedDate` | `DateTime?` | `null` | Selected date | | `MinDate` | `DateTime?` | `null` | Minimum selectable date | | `MaxDate` | `DateTime?` | `null` | Maximum selectable date | ### Events - `SelectedDateChanged` - `EventCallback` fired when date is selected - `@bind-SelectedDate` - Two-way binding for selected date ## Accessibility The Calendar component includes: - Keyboard navigation (Arrow keys, Page Up/Down, Home, End) - Proper ARIA attributes - Screen reader support - Focus management ## Installation ```bash shellui add calendar ```