Seleção e menus
VDatePicker
Date picker flexível para data única ou intervalo, com calendário acessível e presets.
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>Uso
<script setup lang="ts">
</script>
<template>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VDatePicker.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo.
Ver código
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>
<template>
<VDatePicker v-model="value" placeholder="Select date" />
</template>With Icon
Variação Com ícone. Props: variant="with-icon".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDatePicker } from 'vueui-nova-kit'
const value = ref('2026-01-17T03:00:00.000Z')
</script>
<template>
<VDatePicker
v-model="value"
placeholder="Select date"
variant="with-icon" />
</template>With Preset
Variação Com preset. Props: variant="with-preset", range=true.
Ver código
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>
<template>
<VDatePicker
v-model="value"
placeholder="Select date"
variant="with-preset"
range />
</template>Range
Variação Range. Interativo: o estado é mantido na própria story (v-model).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDatePicker } from 'vueui-nova-kit'
const range = ref({
start: '2026-01-10T03:00:00.000Z',
end: '2026-01-17T03:00:00.000Z'
})
</script>
<template>
<VDatePicker variant="range" v-model:range-value="range" range />
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;flex-direction:column;gap:16px;">
<VDatePicker size="sm" />
<VDatePicker size="md" />
<VDatePicker size="lg" />
</div>
</template>Format And Today
Variação Format e Today. Props: format="DD/MM/YYYY", showToday=true, label="Data".
Ver código
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>
<template>
<VDatePicker
v-model="value"
placeholder="Select date"
format="DD/MM/YYYY"
label="Data" />
</template>Clearable
Variação Limpável. Props: clearable=true, label="Data".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDatePicker } from 'vueui-nova-kit'
const value = ref('2026-06-15T03:00:00.000Z')
</script>
<template>
<VDatePicker v-model="value" placeholder="Select date" label="Data" />
</template>Leading Icon
Variação Leading ícone. Props: showLeadingIcon=true, label="Data".
Ver código
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>
<template>
<VDatePicker
v-model="value"
placeholder="Select date"
show-leading-icon
label="Data" />
</template>Min Max Disabled Events
Variação Min Max desabilitado Events. Props: label="Data".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDatePicker } from 'vueui-nova-kit'
const value = ref('2026-06-15T03:00:00.000Z')
const disabledDates = ['2026-06-10T03:00:00.000Z', '2026-06-11T03:00:00.000Z']
const eventDates = ['2026-06-15T03:00:00.000Z', '2026-06-20T03:00:00.000Z']
</script>
<template>
<VDatePicker
v-model="value"
placeholder="Select date"
label="Data"
min="2026-06-05T03:00:00.000Z"
max="2026-06-25T03:00:00.000Z"
:disabled-dates="disabledDates"
:event-dates="eventDates" />
</template>Disabled
Variação Desabilitado. Props: disabled=true, label="Data".
Ver código
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>
<template>
<VDatePicker
v-model="value"
placeholder="Select date"
disabled
label="Data" />
</template>Acessibilidade
Lista "Accessibility — Built with accessibility in mind" (8 itens):
- ARIA label and role support.
- Keyboard navigation (Tab, Arrow keys, Enter, Esc).
- Visible focus indicator.
- Screen reader friendly (announces selected date).
- Proper color contrast.
- Disabled dates are announced.
- Supports both single and range selection.
- Follows WAI-ARIA date picker best practices.
- Implica
role="dialog"/gridno calendário, dias desabilitados comaria-disabled, foco visível no input e nos dias.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | Date | null | null | — |
range | boolean | false | — |
rangeValue | { start: Date | null; end: Date | null } | — | — |
variant | VDatePickerVariant | "default" | — |
size | VDatePickerSize | "md" | — |
disabled | boolean | false | — |
placeholder | string | — | — |
label | string | — | — |
format | string | — | — |
showToday | boolean | true | — |
showLeadingIcon | boolean | — | — |
clearable | boolean | true | — |
min | Date | — | — |
max | Date | — | — |
disabledDates | Date[] | — | — |
eventDates | Date[] | — | — |
preset | string | — | — |
presets | VDatePickerPreset[] | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: Date | null | — |
@update:rangeValue | value: { start: Date | null; end: Date | null } | — |
@change | value: Date | null | — |
@open-change | value: boolean | — |
Slots
Sem slots.
Fonte: src/components/form/VDatePicker/VDatePicker.vue · tipos: src/components/form/VDatePicker/VDatePicker.types.ts