Seleção e menus

VDateRangePicker

Componentev-model8 exemplos13 propsA2UI · DateRangePicker

Seleção de intervalo start-end com calendário duplo, presets e ações Apply/Cancel.

Importação
<script setup lang="ts">
import { VDateRangePicker } 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 VDateRangePicker.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 { ref } from 'vue'
import { VDateRangePicker } from 'vueui-nova-kit'

const value = ref({
  start: '2024-04-01T03:00:00.000Z',
  end: '2024-04-30T03:00:00.000Z',
})
</script>

<template>
  <VDateRangePicker v-model="value" placeholder="Select date range" />
</template>

With Presets

Variação Com presets. Props: variant="presets".

Ver código
vue
<script setup lang="ts">
import { VDateRangePicker } from 'vueui-nova-kit'
</script>

<template>
  <VDateRangePicker
    v-model="value"
    placeholder="Select date range"
    variant="presets" />
</template>

Compact

Variação Compact. Props: variant="compact".

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VDateRangePicker } from 'vueui-nova-kit'

const value = ref({
  start: '2024-04-01T03:00:00.000Z',
  end: '2024-04-30T03:00:00.000Z',
})
</script>

<template>
  <VDateRangePicker
    v-model="value"
    placeholder="Select date range"
    variant="compact" />
</template>

With Time

Variação Com Time. Props: variant="with-time", enableTime=true.

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VDateRangePicker } from 'vueui-nova-kit'

const value = ref({
  start: '2024-04-01T13:00:00.000Z',
  end: '2024-04-05T21:00:00.000Z',
})
</script>

<template>
  <VDateRangePicker
    v-model="value"
    placeholder="Select date range"
    variant="with-time"
    enable-time />
</template>

Sizes

Variação Tamanhos.

Ver código
vue
<script setup lang="ts">
import { VDateRangePicker } from 'vueui-nova-kit'
</script>

<template>
  <div style="display:flex;flex-direction:column;gap:16px;">
    <VDateRangePicker size="sm" />
    <VDateRangePicker size="md" />
    <VDateRangePicker size="lg" />
  </div>
</template>

Format Compact

Variação Format Compact. Props: variant="compact", format="DD/MM/YYYY", compactFormat="DD/MM", label="Período".

Ver código
vue
<script setup lang="ts">
import { VDateRangePicker } from 'vueui-nova-kit'
</script>

<template>
  <VDateRangePicker
    v-model="value"
    placeholder="Select date range"
    variant="compact"
    format="DD/MM/YYYY"
    compact-format="DD/MM"
    label="Período" />
</template>

Min Max Disabled Dates

Variação Min Max desabilitado Dates. Props: label="Período".

Ver código
vue
<script setup lang="ts">
import { VDateRangePicker } from 'vueui-nova-kit'

const disabledDates = ['2026-06-10T03:00:00.000Z']
</script>

<template>
  <VDateRangePicker
    v-model="value"
    placeholder="Select date range"
    label="Período"
    min="2026-06-05T03:00:00.000Z"
    max="2026-06-25T03:00:00.000Z"
    :disabled-dates="disabledDates" />
</template>

Disabled

Variação Desabilitado. Props: disabled=true, label="Período".

Ver código
vue
<script setup lang="ts">
import { VDateRangePicker } from 'vueui-nova-kit'
</script>

<template>
  <VDateRangePicker
    v-model="value"
    placeholder="Select date range"
    disabled
    label="Período" />
</template>

Acessibilidade

  1. Keyboard range selection (Tab, Arrow keys, Enter) — fluxo completo por teclado: abrir, navegar dias, confirmar.
  2. Announces selected date range to screen readers — start/end anunciados via aria-live a cada mudança e no Apply.
  3. Logical focus order (input → calendar → actions) — foco segue campo → calendário → presets → Cancel → Apply.
  4. Clear and descriptive labels — label + placeholder Select date range; ícone decorativo com aria-hidden.
  5. Disabled dates are properly announced — dias indisponíveis com aria-disabled="true" e anúncio "indisponível".
  6. Meets WCAG 2.1 AA contrast requirements — texto, dias selecionados (branco sobre #6366F1) e labels dentro do mínimo AA.

Props

PropTipoDefaultDescrição
modelValueVDateRangeValue | nullnull—
variantVDateRangePickerVariant"default"—
sizeVDateRangePickerSize"md"—
disabledbooleanfalse—
placeholderstring——
labelstring——
formatstring——
compactFormatstring——
enableTimeboolean——
presetsVDateRangePickerPreset[]——
minDate——
maxDate——
disabledDatesDate[]——

Events

EventoPayloadDescrição
@update:modelValuevalue: import('./VDateRangePicker.types').VDateRangeValue | null—
@changevalue: import('./VDateRangePicker.types').VDateRangeValue | null—
@open-changevalue: boolean—
@applyvalue: import('./VDateRangePicker.types').VDateRangeValue | null—
@cancel——

Slots

Sem slots.

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