Seleção e menus
VSegmentedControl
Controle segmentado inline de escolha única entre opções relacionadas — alternativa compacta a tabs para trocar views, períodos ou ordenação.
<script setup lang="ts">
import { VSegmentedControl } 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 VSegmentedControl.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 { VSegmentedControl } from 'vueui-nova-kit'
</script>
<template>
<VSegmentedControl v-model="value" aria-label="Select view mode" />
</template>Text Only
Variação Texto somente. Props: modelValue="week", ariaLabel="Select time range".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const value = ref('week')
const options = [
{ value: 'day', label: 'Day' },
{ value: 'week', label: 'Week' },
{ value: 'month', label: 'Month' },
]
</script>
<template>
<VSegmentedControl
v-model="value"
aria-label="Select time range"
:options="options" />
</template>Icon Only
Variação Ícone somente. Props: modelValue="list", ariaLabel="Select view mode".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const value = ref('list')
const options = [
{ value: 'list', icon: 'list', ariaLabel: 'List view' },
{ value: 'grid', icon: 'grid', ariaLabel: 'Grid view' },
{
value: 'calendar',
icon: 'calendar',
ariaLabel: 'Calendar view',
},
]
</script>
<template>
<VSegmentedControl
v-model="value"
aria-label="Select view mode"
:options="options" />
</template>Icon And Text
Variação Ícone e texto. Props: modelValue="list".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const value = ref('list')
const options = [
{ value: 'list', icon: 'list', label: 'List' },
{ value: 'grid', icon: 'grid', label: 'Grid' },
{ value: 'calendar', icon: 'calendar', label: 'Calendar' },
]
</script>
<template>
<VSegmentedControl
v-model="value"
aria-label="Select view mode"
:options="options" />
</template>Pill
Variação Pill. Props: variant="pill", modelValue="light", ariaLabel="Select theme".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const value = ref('light')
const options = [
{ value: 'light', icon: 'sun', label: 'Light' },
{ value: 'dark', icon: 'moon', label: 'Dark' },
{ value: 'system', icon: 'monitor', label: 'System' },
]
</script>
<template>
<VSegmentedControl
v-model="value"
variant="pill"
aria-label="Select theme"
:options="options" />
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VSegmentedControl } from 'vueui-nova-kit'
</script>
<template>
<div style="display:grid;gap:16px;">
<VSegmentedControl size="sm" :options="[{ value: '7d', label: '7D' }, { value: '30d', label: '30D' }, { value: '3m', label: '3M' }]" model-value="7d" aria-label="Time range small" />
<VSegmentedControl size="md" :options="[{ value: 'day', label: 'Day' }, { value: 'week', label: 'Week' }, { value: 'month', label: 'Month' }]" model-value="week" aria-label="Time range medium" />
<VSegmentedControl size="lg" :options="[{ value: 'newest', label: 'Newest' }, { value: 'oldest', label: 'Oldest' }, { value: 'popular', label: 'Popular' }]" model-value="newest" aria-label="Sort large" />
</div>
</template>Icon Sizes
Variação Ícones por tamanho: ícone e texto, e somente ícone.
Ver código
<script setup lang="ts">
import { VSegmentedControl } from 'vueui-nova-kit'
</script>
<template>
<div style="display:grid;gap:16px;justify-items:start;">
<VSegmentedControl size="sm" model-value="list" aria-label="View small" :options="[{ value: 'list', icon: 'list', label: 'List' }, { value: 'grid', icon: 'grid', label: 'Grid' }]" />
<VSegmentedControl size="md" model-value="list" aria-label="View medium" :options="[{ value: 'list', icon: 'list', label: 'List' }, { value: 'grid', icon: 'grid', label: 'Grid' }]" />
<VSegmentedControl size="lg" model-value="grid" aria-label="View large" :options="[{ value: 'list', icon: 'list', ariaLabel: 'List' }, { value: 'grid', icon: 'grid', ariaLabel: 'Grid' }, { value: 'calendar', icon: 'calendar', ariaLabel: 'Calendar' }]" />
</div>
</template>Full Width
Variação Largura total. Props: fullWidth.
Ver código
<script setup lang="ts">
import { VSegmentedControl } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
ariaLabel: 'Select view mode',
fullWidth: true,
modelValue: 'week',
options: [
{
value: 'day',
label: 'Day'
},
{
value: 'week',
label: 'Week'
},
{
value: 'month',
label: 'Month'
}
]
}
</script>
<template>
<div style="width:420px"><VSegmentedControl v-bind="args" /></div>
</template>Disabled Option
Variação Opção desabilitada. Uma opção com disabled: true.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const value = ref('day')
const options = [
{ value: 'day', label: 'Day' },
{ value: 'week', label: 'Week', disabled: true },
{ value: 'month', label: 'Month' },
]
</script>
<template>
<VSegmentedControl
v-model="value"
aria-label="Select view mode"
:options="options" />
</template>Disabled
Variação Desabilitado. Props: disabled=true, modelValue="week".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const value = ref('week')
const options = [
{ value: 'day', label: 'Day' },
{ value: 'week', label: 'Week' },
{ value: 'month', label: 'Month' },
]
</script>
<template>
<VSegmentedControl
v-model="value"
aria-label="Select view mode"
disabled
:options="options" />
</template>Controlled VModel
Estado controlado: v-model ligado a um ref.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSegmentedControl } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
ariaLabel: 'Select view mode'
}
const value = ref('b')
</script>
<template>
<div style="display:grid;gap:12px"><VSegmentedControl v-bind="args" v-model="value" :options="[{ value: 'a', label: 'Dia' }, { value: 'b', label: 'Semana' }, { value: 'c', label: 'Mês' }]" /></div>
</template>Acessibilidade
- Container:
role="radiogroup" - Segmentos:
role="radio"comaria-checked - Navegação por setas ←/→, Home/End
aria-labelno grupo (obrigatório em icon-only)- Foco visível em cada segmento
Estados
Default · Hover (fundo azul-claro) · Focus-visible (anel 2px) · Pressed · Selected (indicador + texto brand) · Disabled (opacidade reduzida).
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Indicator slide | transform, width | 200ms (--v-segmented-motion) | ease-in-out |
| Hover / pressed | background, color | 100ms | standard |
Respeitar prefers-reduced-motion.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | string | — | — |
options | VSegmentedControlOption[] | — | — |
disabled | boolean | false | — |
fullWidth | boolean | false | Stretch to the container width with equally sized segments. |
size | VSegmentedControlSize | "md" | — |
variant | VSegmentedControlVariant | "default" | — |
ariaLabel | string | — | — |
motion | VMotionLevel | V_MOTION_DEFAULT ("expressive") | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: string | — |
Slots
Sem slots.
Fonte: src/components/navigation/VSegmentedControl/VSegmentedControl.vue · tipos: src/components/navigation/VSegmentedControl/VSegmentedControl.types.ts