Seleção e menus

VSegmentedControl

Componentev-model11 exemplos8 propsA2UI · SegmentedControl

Controle segmentado inline de escolha única entre opções relacionadas — alternativa compacta a tabs para trocar views, períodos ou ordenação.

Importação
<script setup lang="ts">
import { VSegmentedControl } 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 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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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" com aria-checked
  • Navegação por setas ←/→, Home/End
  • aria-label no 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

TriggerPropertyDurationEasing
Indicator slidetransform, width200ms (--v-segmented-motion)ease-in-out
Hover / pressedbackground, color100msstandard

Respeitar prefers-reduced-motion.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
modelValuestring——
optionsVSegmentedControlOption[]——
disabledbooleanfalse—
fullWidthbooleanfalseStretch to the container width with equally sized segments.
sizeVSegmentedControlSize"md"—
variantVSegmentedControlVariant"default"—
ariaLabelstring——
motionVMotionLevelV_MOTION_DEFAULT ("expressive")—

Events

EventoPayloadDescrição
@update:modelValuevalue: string—

Slots

Sem slots.

Fonte: src/components/navigation/VSegmentedControl/VSegmentedControl.vue · tipos: src/components/navigation/VSegmentedControl/VSegmentedControl.types.ts