# Calendar > Date selection calendar component Source: https://shellui.dev/docs/v0.4/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 ``` ## 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; } ``` > **Changed in v0.4** > > `SelectedDateChanged` is now `EventCallback`, so `@bind-SelectedDate` works with a `DateTime?` field. This is a breaking change from 0.3: a handler that takes a `DateTime` must take a `DateTime?`. ## 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 ```