import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { ChevronDownIcon } from '#lib/ui/lucide.ts';
export default function DatePickerDemo() {
return html`
<button type="button" popovertarget="date-picker-demo" aria-haspopup="dialog" aria-expanded="false" data-empty="true" data-slot="button" data-variant="outline" data-size="default" class=${cn(buttonClass({ variant: 'outline' }), 'w-[212px] justify-between text-left font-normal data-[empty=true]:text-muted-foreground')}>
<span>Pick a date</span>
${ChevronDownIcon()}
</button>
<div id="date-picker-demo" popover role="dialog" aria-label="Pick a date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
<ui-calendar mode="single"></ui-calendar>
</div>
`;
}
View Code
Installation
The Date Picker is built using a composition of the popover attribute and the <ui-calendar> component.
See installation instructions for the Popover and the Calendar components.
Usage
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import '#components/ui/calendar.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';
export function DatePickerDemo() {
return html`
<button
type="button"
popovertarget="date-picker"
aria-haspopup="dialog"
aria-expanded="false"
data-empty="true"
class=${cn(buttonClass({ variant: 'outline' }), 'w-[280px] justify-start text-left font-normal data-[empty=true]:text-muted-foreground')}
>
${CalendarIcon()}
<span>Pick a date</span>
</button>
<div id="date-picker" popover role="dialog" aria-label="Pick a date" class=${cn(popoverContentClass(), 'w-auto p-0')}>
<ui-calendar mode="single" name="date"></ui-calendar>
</div>
`;
}
The calendar dispatches ui-value-change with the picked date in detail.value (a "YYYY-MM-DD" string), so a component that wants the trigger to show the date listens for it and re-renders the label. With name, the date also submits with the surrounding form. See the Calendar documentation for more information.
Composition
A date picker is built from a popover and <ui-calendar>:
button[popovertarget]
div[popover] popoverContentClass()
└── ui-calendar
Basic
A basic date picker component.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
export default function DatePickerBasic() {
return html`
<div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-44')}>
<label data-slot="field-label" for="date-picker-simple" class=${fieldLabelClass()}>Date</label>
<button
type="button"
id="date-picker-simple"
popovertarget="date-picker-simple-content"
aria-haspopup="dialog"
aria-expanded="false"
data-slot="button"
data-variant="outline"
data-size="default"
class=${cn(buttonClass({ variant: 'outline' }), 'justify-start font-normal')}
>
<span>Pick a date</span>
</button>
<div id="date-picker-simple-content" popover role="dialog" aria-label="Pick a date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
<ui-calendar mode="single"></ui-calendar>
</div>
</div>
`;
}
View Code
Range Picker
A date picker component for selecting a range of dates.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';
const iso = (d: Date) => d.toISOString().slice(0, 10);
const label = (d: Date) =>
d.toLocaleDateString('en-US', { month: 'short', day: '2-digit', year: 'numeric', timeZone: 'UTC' });
// January 20 to February 9 of this year, as shadcn's demo starts.
export default function DatePickerRange() {
const year = new Date().getFullYear();
const from = new Date(Date.UTC(year, 0, 20));
const to = new Date(Date.UTC(year, 0, 20 + 20));
return html`
<div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-60')}>
<label data-slot="field-label" for="date-picker-range" class=${fieldLabelClass()}>Date Picker Range</label>
<button
type="button"
id="date-picker-range"
popovertarget="date-picker-range-content"
aria-haspopup="dialog"
aria-expanded="false"
data-slot="button"
data-variant="outline"
data-size="default"
class=${cn(buttonClass({ variant: 'outline' }), 'justify-start px-2.5 font-normal')}
>
${CalendarIcon()}
${[label(from), label(to)].join(' - ')}
</button>
<div id="date-picker-range-content" popover role="dialog" aria-label="Pick a date range" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
<ui-calendar mode="range" value=${`${iso(from)}/${iso(to)}`} month=${iso(from).slice(0, 7)} number-of-months="2"></ui-calendar>
</div>
</div>
`;
}
View Code
Date of Birth
A date picker component for selecting a date of birth. This component includes a dropdown caption layout for date and month selection.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
export default function DatePickerDob() {
return html`
<div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-44')}>
<label data-slot="field-label" for="date" class=${fieldLabelClass()}>Date of birth</label>
<button
type="button"
id="date"
popovertarget="date-picker-dob-content"
aria-haspopup="dialog"
aria-expanded="false"
data-slot="button"
data-variant="outline"
data-size="default"
class=${cn(buttonClass({ variant: 'outline' }), 'justify-start font-normal')}
>
Select date
</button>
<div id="date-picker-dob-content" popover role="dialog" aria-label="Date of birth" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto overflow-hidden p-0')}>
<ui-calendar mode="single" caption-layout="dropdown"></ui-calendar>
</div>
</div>
`;
}
View Code
Input
A date picker component with an input field for selecting a date.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import {
inputGroupClass, inputGroupAddonClass, inputGroupButtonClass, inputGroupInputClass,
} from '#components/ui/input-group.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';
function formatDate(date: Date | undefined) {
if (!date) {
return '';
}
return date.toLocaleDateString('en-US', {
day: '2-digit',
month: 'long',
year: 'numeric',
timeZone: 'UTC',
});
}
export default function DatePickerInput() {
const date = new Date('2025-06-01');
return html`
<div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-48')}>
<label data-slot="field-label" for="date-required" class=${fieldLabelClass()}>Subscription Date</label>
<div data-slot="input-group" role="group" class=${inputGroupClass()}>
<input
data-slot="input-group-control"
id="date-required"
value=${formatDate(date)}
placeholder="June 01, 2025"
class=${inputGroupInputClass()}
>
<div role="group" data-slot="input-group-addon" data-align="inline-end" class=${inputGroupAddonClass({ align: 'inline-end' })}>
<button
type="button"
id="date-picker"
popovertarget="date-picker-input-content"
aria-haspopup="dialog"
aria-expanded="false"
aria-label="Select date"
data-slot="button"
data-variant="ghost"
data-size="icon-xs"
class=${inputGroupButtonClass({ size: 'icon-xs', variant: 'ghost' })}
>
${CalendarIcon()}
<span class="sr-only">Select date</span>
</button>
<div id="date-picker-input-content" popover role="dialog" aria-label="Select date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'end', sideOffset: 8 }), 'w-auto overflow-hidden p-0')}>
<ui-calendar mode="single" value="2025-06-01" month="2025-06"></ui-calendar>
</div>
</div>
</div>
</div>
`;
}
View Code
Time Picker
A date picker component with a time input field for selecting a time.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldGroupClass, fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { inputClass } from '#components/ui/input.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { ChevronDownIcon } from '#lib/ui/lucide.ts';
export default function DatePickerTime() {
return html`
<div data-slot="field-group" class=${cn(fieldGroupClass(), 'mx-auto max-w-xs flex-row')}>
<div role="group" data-slot="field" data-orientation="vertical" class=${fieldClass()}>
<label data-slot="field-label" for="date-picker-optional" class=${fieldLabelClass()}>Date</label>
<button
type="button"
id="date-picker-optional"
popovertarget="date-picker-time-content"
aria-haspopup="dialog"
aria-expanded="false"
data-slot="button"
data-variant="outline"
data-size="default"
class=${cn(buttonClass({ variant: 'outline' }), 'w-32 justify-between font-normal')}
>
Select date
${ChevronDownIcon()}
</button>
<div id="date-picker-time-content" popover role="dialog" aria-label="Select date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto overflow-hidden p-0')}>
<ui-calendar mode="single" caption-layout="dropdown"></ui-calendar>
</div>
</div>
<div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'w-32')}>
<label data-slot="field-label" for="time-picker-optional" class=${fieldLabelClass()}>Time</label>
<input
data-slot="input"
type="time"
id="time-picker-optional"
step="1"
value="10:30:00"
class=${cn(inputClass(), 'appearance-none bg-background [&::-webkit-calendar-picker-indicator]:hidden [&::-webkit-calendar-picker-indicator]:appearance-none')}
>
</div>
</div>
`;
}
View Code
Natural Language Picker
A natural language picker turns text such as "In 2 days" into a date. Parse what the reader types with a library of your choice. The demo shows the first paint for "In 2 days".
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import {
inputGroupClass, inputGroupAddonClass, inputGroupButtonClass, inputGroupInputClass,
} from '#components/ui/input-group.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';
function formatDate(date: Date | undefined) {
if (!date) {
return '';
}
return date.toLocaleDateString('en-US', {
day: '2-digit',
month: 'long',
year: 'numeric',
});
}
// shadcn parses the text with chrono-node. The kit ships no parser, so this
// shows the first paint for "In 2 days": the date it resolves to, worked out
// here. Parsing what the reader types is yours to add (any date library).
export default function DatePickerNaturalLanguage() {
const value = 'In 2 days';
const date = new Date();
date.setDate(date.getDate() + 2);
const iso = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
return html`
<div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto max-w-xs')}>
<label data-slot="field-label" for="date-optional" class=${fieldLabelClass()}>Schedule Date</label>
<div data-slot="input-group" role="group" class=${inputGroupClass()}>
<input
data-slot="input-group-control"
id="date-optional"
value=${value}
placeholder="Tomorrow or next week"
class=${inputGroupInputClass()}
>
<div role="group" data-slot="input-group-addon" data-align="inline-end" class=${inputGroupAddonClass({ align: 'inline-end' })}>
<button
type="button"
id="date-picker-natural"
popovertarget="date-picker-natural-content"
aria-haspopup="dialog"
aria-expanded="false"
aria-label="Select date"
data-slot="button"
data-variant="ghost"
data-size="icon-xs"
class=${inputGroupButtonClass({ size: 'icon-xs', variant: 'ghost' })}
>
${CalendarIcon()}
<span class="sr-only">Select date</span>
</button>
<div id="date-picker-natural-content" popover role="dialog" aria-label="Select date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'end', sideOffset: 8 }), 'w-auto overflow-hidden p-0')}>
<ui-calendar mode="single" caption-layout="dropdown" value=${iso} month=${iso.slice(0, 7)}></ui-calendar>
</div>
</div>
</div>
<div class="px-1 text-sm text-muted-foreground">
Your post will be published on
<span class="font-medium">${formatDate(date)}</span>.
</div>
</div>
`;
}
View Code
RTL
To enable RTL support, see the RTL configuration guide.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { ChevronDownIcon } from '#lib/ui/lucide.ts';
const translations = {
en: { dir: 'ltr', values: { placeholder: 'Pick a date' } },
ar: { dir: 'rtl', values: { placeholder: 'اختر تاريخًا' } },
he: { dir: 'rtl', values: { placeholder: 'בחר תאריך' } },
};
// The calendar names its months and days through Intl in the given locale,
// and dir="rtl" flips the grid, the arrow keys and the navigation buttons.
export default function DatePickerRtl() {
const language = 'ar';
const { dir, values: t } = translations[language];
return html`
<button
type="button"
popovertarget="date-picker-rtl"
aria-haspopup="dialog"
aria-expanded="false"
data-empty="true"
dir=${dir}
data-slot="button"
data-variant="outline"
data-size="default"
class=${cn(buttonClass({ variant: 'outline' }), 'w-[212px] justify-between text-left font-normal data-[empty=true]:text-muted-foreground')}
>
<span>${t.placeholder}</span>
${ChevronDownIcon()}
</button>
<div id="date-picker-rtl" popover role="dialog" aria-label=${t.placeholder} dir=${dir} data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
<ui-calendar mode="single" locale=${language} dir=${dir}></ui-calendar>
</div>
`;
}