Seleção e menus

VDatePicker

Componentev-model10 exemplos18 propsA2UI · DatePicker

Date picker flexível para data única ou intervalo, com calendário acessível e presets.

Importação
<script setup lang="ts">
import { VDatePicker } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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"/grid no calendário, dias desabilitados com aria-disabled, foco visível no input e nos dias.

Props

PropTipoDefaultDescrição
modelValueDate | nullnull—
rangebooleanfalse—
rangeValue{ start: Date | null; end: Date | null }
{ start: Date | null; end: Date | null; }
——
variantVDatePickerVariant"default"—
sizeVDatePickerSize"md"—
disabledbooleanfalse—
placeholderstring——
labelstring——
formatstring——
showTodaybooleantrue—
showLeadingIconboolean——
clearablebooleantrue—
minDate——
maxDate——
disabledDatesDate[]——
eventDatesDate[]——
presetstring——
presetsVDatePickerPreset[]——

Events

EventoPayloadDescrição
@update:modelValuevalue: Date | null—
@update:rangeValuevalue: { start: Date | null; end: Date | null }—
@changevalue: Date | null—
@open-changevalue: boolean—

Slots

Sem slots.

Fonte: src/components/form/VDatePicker/VDatePicker.vue · tipos: src/components/form/VDatePicker/VDatePicker.types.ts