Hotel stay
Collect check-in and check-out calendar dates as separate form values.
Components / Forms
A two-month range picker with continuous selection bands and native form values.
Last changed in version 0.14.2: Improve keyboard navigation, action feedback, and selected colors across Vue components.
bunx --bun @getweini/cli@latest add date-picker-rangeImport the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task.
<script setup lang="ts">
import { ref } from 'vue'
import DatePickerRange from './components/ui/date-picker-range/DatePickerRange.vue'
const stay = ref<[string, string]>(['', ''])
</script>
<template>
<label for="stay-dates">Stay dates</label>
<DatePickerRange
id="stay-dates"
v-model="stay"
start-name="checkIn"
end-name="checkOut"
min="2026-01-01"
locale="en-GB"
:messages="{
calendarLabel: 'Choose check-in and check-out dates',
previousMonth: 'Previous month',
nextMonth: 'Next month',
chooseDates: 'Choose dates',
chooseEndDate: 'Choose end date',
clearSelection: 'Clear dates',
}"
/>
</template>Two adjacent months make cross-month ranges visible at once. Narrow screens stack both months in a scrollable calendar. The first click starts a range and the second completes it; selected dates form continuous week-row bands. Set both name props to submit the two native values.
Collect check-in and check-out calendar dates as separate form values.
Limit both endpoints to an allowed reporting window.
Both name props are needed for native form submission.
<script setup lang="ts">
import { ref } from 'vue'
import DatePickerRange from './components/ui/date-picker-range/DatePickerRange.vue'
const stay = ref<[string, string]>(['', ''])
const messages = {
calendarLabel: 'Choose stay dates',
previousMonth: 'Previous month',
nextMonth: 'Next month',
chooseDates: 'Choose dates',
chooseEndDate: 'Choose check-out date',
clearSelection: 'Clear dates',
}
</script>
<template>
<label for="stay">Stay dates</label>
<DatePickerRange
id="stay"
v-model="stay"
start-name="checkIn"
end-name="checkOut"
locale="en-GB"
:first-day-of-week="1"
:messages="messages"
required
/>
</template>Use Sunday-first layout where it matches the audience convention.
<script setup lang="ts">
import { ref } from 'vue'
import DatePickerRange from './components/ui/date-picker-range/DatePickerRange.vue'
const interval = ref<[string, string]>(['', ''])
const messages = {
calendarLabel: 'Choose reporting dates',
previousMonth: 'Previous month',
nextMonth: 'Next month',
chooseDates: 'Choose dates',
chooseEndDate: 'Choose end date',
clearSelection: 'Clear dates',
}
</script>
<template>
<label for="report-dates">Reporting dates</label>
<DatePickerRange
id="report-dates"
v-model="interval"
min="2026-01-01"
max="2026-12-31"
locale="en-US"
:first-day-of-week="0"
:messages="messages"
/>
</template>Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element.
| Name | Type or signature | Default | What it does |
|---|---|---|---|
nameprop | string | undefined | Not set | Name used when this control submits a value with a form. |
referenceDateprop | string | undefined | Not set | Stable date used to decide which month or year appears first. |
idprop | string | undefined | Not set | Give the control an ID so a label or description can refer to it. |
startNameprop | string | undefined | Not set | Form field name used for the start of the range. |
endNameprop | string | undefined | Not set | Form field name used for the end of the range. |
formprop | string | undefined | Not set | Associate the control with a form by its ID. |
sizeprop | ControlSize | undefined | "md" | Choose the visual size. Medium is the usual default where available. |
invalidprop | boolean | undefined | Not set | Show the invalid state; also provide a visible error message. |
disabledprop | boolean | undefined | Not set | Prevent interaction and show the disabled state. |
readonlyprop | boolean | undefined | Not set | Show the value while preventing edits. |
requiredprop | boolean | undefined | Not set | Ask the browser to require a value before form submission. |
minprop | string | undefined | Not set | Smallest allowed value. |
maxprop | string | undefined | Not set | Largest allowed value. |
localeprop | string | undefined | Not set | Choose the language and regional formatting for dates or text. |
firstDayOfWeekprop | 0 | 1 | 2 | 3 | 4 | 5 | 6 | undefined | 1 | Choose which weekday begins each calendar row. |
messagesprop | DatePickerRangeMessages | Required | Supply the text this component displays for its built-in actions and states. |
modelValuemodel | DatePickerRangeValue | undefined | ["", ""] | Current value. Use v-model to keep it in sync with your page. |
update:modelValueevent | [value: DatePickerRangeValue] | — | Requests a new model value from the parent. |
errorslot | { message: string; messages: string[]; } | Optional | Content for the error area of DatePickerRange. |
startElementexposed | HTMLInputElement | null | — | Access start element from a component template ref. |
endElementexposed | HTMLInputElement | null | — | Access end element from a component template ref. |
triggerElementexposed | HTMLButtonElement | null | — | Access trigger element from a component template ref. |
focusexposed | () => void | undefined | — | Move keyboard focus to this control. |
showPickerexposed | () => void | — | Access show picker from a component template ref. |
openexposed | () => void | — | Open this component from application code. |
closeexposed | (restoreFocus?: boolean) => void | — | Close this component from application code. |
// packages/frameworks/vue/components/date-picker-range/types.ts
import type { ControlSize } from '@getweini/vue/types'
export type DatePickerRangeValue = [string, string]
export interface DatePickerRangeMessages {
calendarLabel: string
previousMonth: string
nextMonth: string
chooseDates: string
chooseEndDate: string
clearSelection: string
}
export interface DatePickerRangeProps {
name?: string
referenceDate?: string
id?: string
startName?: string
endName?: string
form?: string
size?: ControlSize
invalid?: boolean
disabled?: boolean
readonly?: boolean
required?: boolean
min?: string
max?: string
locale?: string
firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6
messages: DatePickerRangeMessages
}
// packages/frameworks/vue/dist/types/index.d.ts
export type { ButtonOptions, ButtonProps } from './button';
export type ControlSize = 'sm' | 'md' | 'lg';
export interface SelectOption<T = unknown> {
label: string;
value: T;
disabled?: boolean;
}
/** Application-owned copy. Bind translated strings reactively when the locale changes. */
export interface ListboxMessages {
/** Popup name when no aria-label or aria-labelledby is supplied. */
listboxLabel: string;
empty: string;
clearSelection: string;
}
export interface ListboxProps<T> {
options: readonly SelectOption<T>[];
messages: ListboxMessages;
id?: string;
disabled?: boolean;
required?: boolean;
invalid?: boolean;
name?: string;
form?: string;
placeholder?: string;
size?: ControlSize;
clearable?: boolean;
gap?: number;
/** Supply stable equality for object values. Values must be unique. */
by?: (a: T, b: T) => boolean;
/** Required for meaningful form submission of object values. */
serialize?: (value: T) => string;
}
// packages/frameworks/vue/dist/types/button.d.ts
import type { Component } from 'vue';
/** Options shared by button implementations across frameworks. */
export interface ButtonOptions<Variant extends string = string, Size extends string = string> {
variant?: Variant;
size?: Size;
disabled?: boolean;
loading?: boolean;
type?: 'button' | 'submit' | 'reset';
}
/** Vue-specific target options extend the reusable button contract. */
export interface ButtonProps<Variant extends string = 'default' | 'secondary' | 'outline' | 'ghost' | 'destructive', Size extends string = 'sm' | 'md' | 'lg'> extends ButtonOptions<Variant, Size> {
as?: 'button' | 'a' | Component;
asChild?: boolean;
}[start, end] tuple of YYYY-MM-DD strings; the end is empty while the user is choosing.