# 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
```