Seleção e menus
VDateRangePicker
Seleção de intervalo start-end com calendário duplo, presets e ações Apply/Cancel.
<script setup lang="ts">
import { VDateRangePicker } 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 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
<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
<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
<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
<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
<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
<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
<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
<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
- Keyboard range selection (Tab, Arrow keys, Enter) — fluxo completo por teclado: abrir, navegar dias, confirmar.
- Announces selected date range to screen readers — start/end anunciados via
aria-livea cada mudança e no Apply. - Logical focus order (input → calendar → actions) — foco segue campo → calendário → presets → Cancel → Apply.
- Clear and descriptive labels —
label+ placeholderSelect date range; ícone decorativo comaria-hidden. - Disabled dates are properly announced — dias indisponíveis com
aria-disabled="true"e anúncio "indisponível". - Meets WCAG 2.1 AA contrast requirements — texto, dias selecionados (branco sobre
#6366F1) e labels dentro do mínimo AA.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | VDateRangeValue | null | null | — |
variant | VDateRangePickerVariant | "default" | — |
size | VDateRangePickerSize | "md" | — |
disabled | boolean | false | — |
placeholder | string | — | — |
label | string | — | — |
format | string | — | — |
compactFormat | string | — | — |
enableTime | boolean | — | — |
presets | VDateRangePickerPreset[] | — | — |
min | Date | — | — |
max | Date | — | — |
disabledDates | Date[] | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: import('./VDateRangePicker.types').VDateRangeValue | null | — |
@change | value: import('./VDateRangePicker.types').VDateRangeValue | null | — |
@open-change | value: boolean | — |
@apply | value: import('./VDateRangePicker.types').VDateRangeValue | null | — |
@cancel | — | — |
Slots
Sem slots.
Fonte: src/components/form/VDateRangePicker/VDateRangePicker.vue · tipos: src/components/form/VDateRangePicker/VDateRangePicker.types.ts