Svelte Datepicker - Bitblue

Use the Datepicker component to allow users to select a date or date range with an interactive calendar interface

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 title or associated Label for the input.
  • Use required / disabled for form semantics; announce selection via visible text when needed.

Props

PropTypeDefaultDescription
valueDate—Bindable selected date
defaultDateDate | null—Initial calendar focus
rangeboolean—Enable range mode
rangeFrom / rangeToDate—Bindable range ends
availableFrom / availableToDate | null—Selectable bounds
localestring—Display locale
translationLocalestring—Translation locale
firstDayOfWeekDay—Week start
dateFormatIntl.DateTimeFormatOptions—Input display format
placeholderstring—Empty input text
disabled / requiredboolean—Native constraints
colorButton color—Accent / selected day color
monthColorButton color—Month button color
inlinebooleanfalseAlways-visible calendar
autohideboolean—Close after select
showActionButtonsboolean—Today / Clear / Apply
titlestring—Calendar title
onselect(x: DateOrRange) => void—Selection callback
onclear() => void—Clear action
onapply(x: DateOrRange) => void—Apply action
inputmodeHTML inputmode—Mobile keyboard mode
btnClass / inputClassClassValue—Button / input classes
monthBtnSelected / monthBtnClassValue—Month button classes
elementRefHTMLInputElement—Bindable input element
namestring | null—Form field name
placementFloating placementbottom-startPopup placement
classestheme slots—Slot class overrides
classClassValue—Extra root classes

FormDatepicker

FormDatepicker extends DatepickerProps with required name, optional label and contextKey. Must be a child of Form.


© 2026 Bitblue is a registered trademark. All Rights Reserved.