DatePickerWindow
The date picker window can be used as a standalone component to select dates or date ranges. It is typically used as the DatePicker, but can also be used on its own.
Showcase
Nov.2026
| Mon | Tue | Wed | Thu | Fri | Sat | Sun |
|---|---|---|---|---|---|---|
| 26 | 27 | 28 | 29 | 30 | 31 | 1 |
| 2 | 3 | 4 | 5 | 6 | 7 | 8 |
| 9 | 10 | 11 | 12 | 13 | 14 | 15 |
| 16 | 17 | 18 | 19 | 20 | 21 | 22 |
| 23 | 24 | 25 | 26 | 27 | 28 | 29 |
| 30 | 1 | 2 | 3 | 4 | 5 | 6 |
<LnxDatePickerWindow v-model="..." <-- Pass a reactive variable here to bind its value v-model:start="..." <-- Pass a reactive variable here to bind its value v-model:end="..." <-- Pass a reactive variable here to bind its value @update:modelValue="..." <-- Two way binding of the component @update:start="..." <-- Two way binding of the component start date @update:end="..." <-- Two way binding of the component end date />
v-model:start
DateBinds the selected start date. Should be used with the `isRange` prop as `true` Default value: undefinedv-model:end
DateBinds the selected end date. Should be used with the `isRange` prop as `true` Default value: undefinedmonthsNames
string[]Names of months to be shown. By default, from the `createLnx` locale Default value: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']weekDaysNames
string[]Names of week days to be shown in the header of the month, starting on Sunday. By default, from the `createLnx` locale Default value: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']firstDayOfWeek
numberDay to be used as the start of the week, from 0 (Sunday) to 6. By default, from the `createLnx` locale, or Monday Default value: 1todayText
stringText for the "select today" button. By default, the `today` text of `createLnx` Default value: "Today"min
Date | stringThe first date that can be selected, as a `Date` or as `YYYY-MM-DD`. Days before it are disabled, and months and years only when all their days are Default value: undefinedmax
Date | stringThe last date that can be selected, as a `Date` or as `YYYY-MM-DD`. Days after it are disabled, and months and years only when all their days are Default value: undefinedisItemDisabledFn
((item: Item) => boolean) | nullA function that sets an item as disabled. It adds to `min` and `max` Default value: () => falsecalendarType
CalendarViewTypeWhat is going to be the selection type of the calendar Default value: CALENDAR_VIEW_TYPES.DAYisRange
booleanIf two dates in a range can be selected, or if it's a single date selection Default value: falseDates and timezones
Selected dates are emitted at 00:00 UTC (for example, 2026-11-05T00:00:00.000Z), and the dates you pass in are read in UTC, so every user sees the same day whatever their timezone. To set a value, use a date at 00:00 UTC such as new Date('2026-11-05') or new Date(Date.UTC(2026, 10, 5)). Avoid new Date() or new Date(2026, 10, 5): they are local times, and in some timezones they fall on another day in UTC.
When to use
- When the calendar should always be visible: a booking page, a filter panel or a dashboard.
- For a date field in a form, use a DatePicker: it shows the calendar only while picking.
Examples
Single date
Nov.2026
| Mon | Tue | Wed | Thu | Fri | Sat | Sun |
|---|---|---|---|---|---|---|
| 26 | 27 | 28 | 29 | 30 | 31 | 1 |
| 2 | 3 | 4 | 5 | 6 | 7 | 8 |
| 9 | 10 | 11 | 12 | 13 | 14 | 15 |
| 16 | 17 | 18 | 19 | 20 | 21 | 22 |
| 23 | 24 | 25 | 26 | 27 | 28 | 29 |
| 30 | 1 | 2 | 3 | 4 | 5 | 6 |
vue
<LnxDatePickerWindow v-model="day" />1
Date range
Nov.2026
| Mon | Tue | Wed | Thu | Fri | Sat | Sun |
|---|---|---|---|---|---|---|
| 26 | 27 | 28 | 29 | 30 | 31 | 1 |
| 2 | 3 | 4 | 5 | 6 | 7 | 8 |
| 9 | 10 | 11 | 12 | 13 | 14 | 15 |
| 16 | 17 | 18 | 19 | 20 | 21 | 22 |
| 23 | 24 | 25 | 26 | 27 | 28 | 29 |
| 30 | 1 | 2 | 3 | 4 | 5 | 6 |
Dec.2026
| Mon | Tue | Wed | Thu | Fri | Sat | Sun |
|---|---|---|---|---|---|---|
| 30 | 1 | 2 | 3 | 4 | 5 | 6 |
| 7 | 8 | 9 | 10 | 11 | 12 | 13 |
| 14 | 15 | 16 | 17 | 18 | 19 | 20 |
| 21 | 22 | 23 | 24 | 25 | 26 | 27 |
| 28 | 29 | 30 | 31 | 1 | 2 | 3 |
| 4 | 5 | 6 | 7 | 8 | 9 | 10 |
vue
<LnxDatePickerWindow v-model:start="rangeStart" v-model:end="rangeEnd" is-range />1
API
Props
| Prop | Type | Description |
|---|---|---|
v-model | Date | Binds the selected date to the reactive variable used as prop |
v-model:start | Date | Binds the selected start date. Should be used with the isRange prop as true |
v-model:end | Date | Binds the selected end date. Should be used with the isRange prop as true |
months-names | string[] | Names of months to be shown. By default, from the createLnx localeDefault: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'] |
week-days-names | string[] | Names of week days to be shown in the header of the month, starting on Sunday. By default, from the createLnx localeDefault: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'] |
first-day-of-week | number | Day to be used as the start of the week, from 0 (Sunday) to 6. By default, from the createLnx locale, or MondayDefault: 1 |
today-text | string | Text for the "select today" button. By default, the today text of createLnxDefault: "Today" |
min | Date | string | The first date that can be selected, as a Date or as YYYY-MM-DD. Days before it are disabled, and months and years only when all their days are |
max | Date | string | The last date that can be selected, as a Date or as YYYY-MM-DD. Days after it are disabled, and months and years only when all their days are |
is-item-disabled-fn | ((item: Item) => boolean) | null | A function that sets an item as disabled. It adds to min and maxDefault: () => false |
calendar-type | CalendarViewType | What is going to be the selection type of the calendar Default: CALENDAR_VIEW_TYPES.DAY |
is-range | boolean | If two dates in a range can be selected, or if it's a single date selection Default: false |
allow-deselect | boolean | If clicking over a selected date will deselect it Default: false |
Events
| Event | Payload | Description |
|---|---|---|
update:modelValue | Date | Two way binding of the component |
update:start | Date | Two way binding of the component start date |
update:end | Date | Two way binding of the component end date |
Types
Item
ts
export type Item = Day | Month | Year;1
ts
export interface Day {
number: number;
weekDay: number;
month: number;
year: number;
isDisabled?: boolean;
}1
2
3
4
5
6
7
2
3
4
5
6
7
ts
export interface Month {
number: number;
year: number;
isDisabled?: boolean;
}1
2
3
4
5
2
3
4
5
ts
export interface Year {
number: number;
isDisabled?: boolean;
}1
2
3
4
2
3
4
CalendarViewType
ts
export const CALENDAR_VIEW_TYPES = {
DAY: 'day',
MONTH: 'month',
YEAR: 'year',
};
export type CalendarViewType = ValueOf<typeof CALENDAR_VIEW_TYPES>;1
2
3
4
5
6
2
3
4
5
6