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