Calendar
Date selection calendar component
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.
Basic Usage
razor
<Calendar SelectedDate="@selectedDate" SelectedDateChanged="@HandleDateChanged" />
@code {
private DateTime? selectedDate;
private void HandleDateChanged(DateTime date)
{
selectedDate = date;
}
}
Single Date Selection
razor
<Calendar SelectedDate="@date" SelectedDateChanged="@HandleDateChanged" />
@code {
private DateTime? date = DateTime.Today;
private void HandleDateChanged(DateTime date)
{
this.date = date;
}
}
Or with two-way binding:
razor
<Calendar @bind-SelectedDate="date" />
@code {
private DateTime date = DateTime.Today;
}
Bind to a non-nullable DateTime
In 0.3.x, SelectedDate is DateTime? but SelectedDateChanged is EventCallback<DateTime>, 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
<Button Variant="ButtonVariant.Outline" OnClick="() => showCalendar = !showCalendar">
@(selectedDate?.ToString("MM/dd/yyyy") ?? "Pick a date")
</Button>
@if (showCalendar)
{
<div class="absolute z-50 mt-2">
<Calendar SelectedDate="@selectedDate" SelectedDateChanged="@HandleDateChanged" />
</div>
}
@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
<Calendar
SelectedDate="@date"
SelectedDateChanged="@HandleDateChanged"
MinDate="DateTime.Today"
MaxDate="DateTime.Today.AddMonths(3)" />
@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<DateTime>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