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

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.