The Datepicker provides an interactive calendar for single dates or ranges. For validated forms, use FormDatepicker inside a parent Form. FormDatepicker requires Form context.
Setup
<script>
import { Datepicker } from '.';
</script> Default Datepicker
Selected date: None
<script lang="ts">
import { Datepicker } from '.';
let selectedDate = $state<Date | undefined>(undefined);
</script>
<div class="mb-64 md:w-1/2">
<Datepicker bind:value={selectedDate} />
<p class="mt-4">Selected date: {selectedDate ? selectedDate.toLocaleDateString() : 'None'}</p>
</div> Date range selection
Selected range: None - None
<script lang="ts">
import { Datepicker } from '.';
let dateRange: { from: Date | undefined; to: Date | undefined } = $state({
from: undefined,
to: undefined
});
</script>
<div class="md:w-1/2">
<Datepicker range bind:rangeFrom={dateRange.from} bind:rangeTo={dateRange.to} color="pink" />
<p class="mt-4">
Selected range:
{dateRange.from ? dateRange.from.toLocaleDateString() : 'None'} -
{dateRange.to ? dateRange.to.toLocaleDateString() : 'None'}
</p>
</div> Inline Datepicker
Selected date: None
<script lang="ts">
import { Datepicker } from '.';
let selectedDate = $state<Date | undefined>(undefined);
</script>
<div class="md:w-1/2">
<Datepicker inline bind:value={selectedDate} />
<p class="mt-4">Selected date: {selectedDate ? selectedDate.toLocaleDateString() : 'None'}</p>
</div> Color and classes
Colors: primary (default), blue, red, green, yellow, purple, dark, light, alternative, secondary, gray, orange, amber, lime, emerald, teal, cyan, sky, indigo, violet, fuchsia, pink, rose.
classes slots: base, input, titleVariant, polite, button, actionButtons, columnHeader, grid, nav, dayButton, monthButton.
<script lang="ts">
import { Datepicker } from '.';
</script>
<div class="md:w-1/2">
<Datepicker
color="blue"
classes={{
polite: 'hover:text-blue-700!',
dayButton: 'hover:text-blue-400',
titleVariant: 'text-blue-800',
monthButton: 'text-blue-700'
}}
title="Select your preferred date"
monthBtnSelected="bg-blue-200"
/>
</div> Localization
<script lang="ts">
import { Datepicker } from '.';
</script>
<div class="mb-64 md:w-1/2">
<Datepicker locale="fr-FR" />
</div> Custom date format
<script lang="ts">
import { Datepicker } from '.';
</script>
<div class="mb-64 md:w-1/2">
<Datepicker dateFormat={{ year: 'numeric', month: 'short', day: '2-digit' }} />
</div> Action buttons
Selected date: None
Last action:
<script lang="ts">
import { Datepicker, type DateOrRange } from '.';
let selectedDate = $state<Date | undefined>(undefined);
let lastAction = $state<string | undefined>();
function handleClear() {
lastAction = 'Cleared';
}
function handleApply(detail: DateOrRange): void {
lastAction = 'Applied';
if (detail instanceof Date) {
selectedDate = detail;
}
}
</script>
<div class="mb-64 md:w-1/2">
<Datepicker
bind:value={selectedDate}
showActionButtons
autohide={false}
onclear={handleClear}
onapply={handleApply}
/>
<p class="mt-4">Selected date: {selectedDate ? selectedDate.toLocaleDateString() : 'None'}</p>
<p class="mt-2">Last action: {lastAction}</p>
</div> Restricting the selectable date range
Available from: November 9, 2026 to: November 29, 2026
Selected date: None selected
Today: November 19, 2026
Range: 10 days before today to 10 days after today
<script lang="ts">
import { Datepicker } from '.';
let selectedDate = $state<Date | undefined>(undefined);
function addDays(date: Date, days: number): Date {
const result = new Date(date);
result.setDate(result.getDate() + days);
return result;
}
const today = new Date();
const availableFrom = addDays(today, -10);
const availableTo = addDays(today, 10);
function formatDate(date: Date): string {
return date.toLocaleDateString('en-US', {
year: 'numeric',
month: 'long',
day: 'numeric'
});
}
</script>
<Datepicker
bind:value={selectedDate}
{availableFrom}
{availableTo}
placeholder="Select available date"
/>
<p class="mt-4">Available from: {formatDate(availableFrom)} to: {formatDate(availableTo)}</p>
<p>Selected date: {selectedDate ? formatDate(selectedDate) : 'None selected'}</p> Accessibility
- Keyboard-friendly calendar navigation; disabled/unavailable days are non-interactive.
- Provide a
titleor associatedLabelfor the input. - Use
required/disabledfor form semantics; announce selection via visible text when needed.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
value | Date | — | Bindable selected date |
defaultDate | Date | null | — | Initial calendar focus |
range | boolean | — | Enable range mode |
rangeFrom / rangeTo | Date | — | Bindable range ends |
availableFrom / availableTo | Date | null | — | Selectable bounds |
locale | string | — | Display locale |
translationLocale | string | — | Translation locale |
firstDayOfWeek | Day | — | Week start |
dateFormat | Intl.DateTimeFormatOptions | — | Input display format |
placeholder | string | — | Empty input text |
disabled / required | boolean | — | Native constraints |
color | Button color | — | Accent / selected day color |
monthColor | Button color | — | Month button color |
inline | boolean | false | Always-visible calendar |
autohide | boolean | — | Close after select |
showActionButtons | boolean | — | Today / Clear / Apply |
title | string | — | Calendar title |
onselect | (x: DateOrRange) => void | — | Selection callback |
onclear | () => void | — | Clear action |
onapply | (x: DateOrRange) => void | — | Apply action |
inputmode | HTML inputmode | — | Mobile keyboard mode |
btnClass / inputClass | ClassValue | — | Button / input classes |
monthBtnSelected / monthBtn | ClassValue | — | Month button classes |
elementRef | HTMLInputElement | — | Bindable input element |
name | string | null | — | Form field name |
placement | Floating placement | bottom-start | Popup placement |
classes | theme slots | — | Slot class overrides |
class | ClassValue | — | Extra root classes |
FormDatepicker
FormDatepicker extends DatepickerProps with required name, optional label and contextKey. Must be a child of Form.