Date Picker
Date input with calendar popup for date selection
The DatePicker component combines a button trigger with a calendar popup for selecting dates. It supports two-way binding, placeholder text, clear functionality, and disabled state.
Installation
bash
shellui add date-picker
Basic Usage
<div class="w-full max-w-sm">
<DatePicker @bind-Value="selectedDate" />
</div>
@code {
private DateTime? selectedDate;
}
With Placeholder
<div class="w-full max-w-sm space-y-2">
<Label>Date of Birth</Label>
<DatePicker @bind-Value="dateOfBirth"
Placeholder="Pick a date" />
</div>
@code {
private DateTime? dateOfBirth;
}
With Clear Button
Allow users to clear the selected date (enabled by default):
<div class="w-full max-w-sm">
<DatePicker @bind-Value="selectedDate"
AllowClear="true"
Placeholder="Select a date" />
</div>
@code {
private DateTime? selectedDate = DateTime.Today;
}
To disable clearing:
<div class="w-full max-w-sm">
<DatePicker @bind-Value="selectedDate"
AllowClear="false" />
</div>
@code {
private DateTime? selectedDate = DateTime.Today;
}
Disabled State
<div class="w-full max-w-sm">
<DatePicker @bind-Value="selectedDate"
Disabled="true"
Placeholder="Not available" />
</div>
@code {
private DateTime? selectedDate = DateTime.Today;
}
In a Form
<div class="w-full max-w-sm">
<EditForm Model="@model" OnValidSubmit="HandleSubmit">
<div class="grid gap-4">
<div class="space-y-2">
<Label>Event Name</Label>
<Input @bind-Value="model.Name" />
</div>
<div class="space-y-2">
<Label>Event Date</Label>
<DatePicker @bind-Value="model.Date"
Placeholder="Pick event date" />
</div>
<Button Type="submit">Create Event</Button>
</div>
</EditForm>
</div>
@code {
private EventModel model = new();
private void HandleSubmit()
{
// Handle submission
}
class EventModel
{
public string Name { get; set; } = "";
public DateTime? Date { get; set; }
}
}
Controlled State
Selected: None
<div class="flex flex-wrap items-center gap-4">
<DatePicker @bind-Value="selectedDate" Class="w-full max-w-72" />
<p class="text-sm text-muted-foreground">
Selected: @(selectedDate?.ToString("MMM dd, yyyy") ?? "None")
</p>
</div>
@code {
private DateTime? selectedDate;
}
Side-by-Side Date Range
Use two DatePicker components for a date range:
to
<div class="flex flex-wrap items-center gap-2">
<DatePicker @bind-Value="startDate" Placeholder="Start date" Class="w-full max-w-72" />
<span class="text-sm text-muted-foreground">to</span>
<DatePicker @bind-Value="endDate" Placeholder="End date" Class="w-full max-w-72" />
</div>
@code {
private DateTime? startDate;
private DateTime? endDate;
}
API Reference
| Property | Type | Default | Description |
|---|---|---|---|
Value |
DateTime? |
null |
Selected date value |
ValueChanged |
EventCallback<DateTime?> |
— | Two-way binding callback |
Placeholder |
string |
"Pick a date" |
Text shown when no date is selected |
Disabled |
bool |
false |
Disable the date picker |
AllowClear |
bool |
true |
Show a clear button when a date is selected |
SelectedDate / SelectedDateChanged |
DateTime? |
null |
Deprecated from 0.3.5: use Value / @bind-Value |
Class |
string? |
null |
Additional CSS classes |
Display Format
The selected date is displayed as "MMM dd, yyyy" (e.g., "Feb 08, 2026"). The calendar popup provides month navigation with Previous/Next buttons.
Accessibility
The DatePicker component includes:
- Calendar popup as an overlay with click-outside dismiss
- Keyboard navigation within the calendar grid
- Month navigation via Previous/Next buttons
- Clear button with proper labeling
aria-labelon the trigger button