Navegação

VStepper

Componentev-model9 exemplos7 propsA2UI · Stepper

Componente VueUI Nova para **stepper**, seguindo tokens semânticos e Light Mode como referência principal.

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

const value = ref('profile')
const steps = [
  { value: 'account', label: 'Account' },
  { value: 'profile', label: 'Profile' },
  { value: 'review', label: 'Review' },
  { value: 'confirm', label: 'Confirm' },
]
</script>

<template>
  <VStepper v-model="value" :steps="steps" />
</template>

First Step

Variação First Step. Props: modelValue="account".

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

const value = ref('account')
const steps = [
  { value: 'account', label: 'Account' },
  { value: 'profile', label: 'Profile' },
  { value: 'review', label: 'Review' },
  { value: 'confirm', label: 'Confirm' },
]
</script>

<template>
  <VStepper v-model="value" :steps="steps" />
</template>

Last Step

Variação Last Step. Props: modelValue="confirm".

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

const value = ref('confirm')
const steps = [
  { value: 'account', label: 'Account' },
  { value: 'profile', label: 'Profile' },
  { value: 'review', label: 'Review' },
  { value: 'confirm', label: 'Confirm' },
]
</script>

<template>
  <VStepper v-model="value" :steps="steps" />
</template>

With Descriptions

Variação Com Descriptions. Props: modelValue="profile".

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

const value = ref('profile')
const steps = [
  {
    value: 'account',
    label: 'Account',
    description: 'Sign in details',
  },
  {
    value: 'profile',
    label: 'Profile',
    description: 'Personal info',
  },
  {
    value: 'review',
    label: 'Review',
    description: 'Verify data',
  },
  {
    value: 'confirm',
    label: 'Confirm',
    description: 'Finish setup',
  },
]
</script>

<template>
  <VStepper v-model="value" :steps="steps" />
</template>

Interactive

Variação Interativo. Interativo: o estado é mantido na própria story (v-model).

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

const args = {
  modelValue: 'profile',
  steps: [
    {
      value: 'account',
      label: 'Account'
    },
    {
      value: 'profile',
      label: 'Profile'
    },
    {
      value: 'review',
      label: 'Review'
    },
    {
      value: 'confirm',
      label: 'Confirm'
    }
  ],
  size: 'md',
  variant: 'default'
}
const current = ref('profile')
</script>

<template>
  <div>
    <VStepper v-bind="args" v-model="current" />
    <p style="margin-top:12px;color:var(--v-color-text-muted);font-size:14px;">Current step: {{ current }}</p>
  </div>
</template>

Disabled

Variação Desabilitado. Props: disabled=true.

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

const value = ref('profile')
const steps = [
  { value: 'account', label: 'Account' },
  { value: 'profile', label: 'Profile' },
  { value: 'review', label: 'Review' },
  { value: 'confirm', label: 'Confirm' },
]
</script>

<template>
  <VStepper v-model="value" :steps="steps" disabled />
</template>

Loading

Variação Carregando. Props: loading=true.

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

const value = ref('profile')
const steps = [
  { value: 'account', label: 'Account' },
  { value: 'profile', label: 'Profile' },
  { value: 'review', label: 'Review' },
  { value: 'confirm', label: 'Confirm' },
]
</script>

<template>
  <VStepper v-model="value" :steps="steps" loading />
</template>

Sizes

Variação Tamanhos.

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

<template>
  <div style="display:flex;flex-direction:column;gap:24px;">
    <VStepper size="sm" model-value="profile" />
    <VStepper size="md" model-value="profile" />
    <VStepper size="lg" model-value="profile" />
  </div>
</template>

Variants

Variação Variantes.

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

<template>
  <div style="display:flex;flex-direction:column;gap:24px;">
    <VStepper variant="default" model-value="review" />
    <VStepper variant="primary" model-value="review" />
    <VStepper variant="subtle" model-value="review" />
  </div>
</template>

Acessibilidade

Semântica nativa primeiro, foco visível, labels acessíveis e teclado conforme o padrão WAI-ARIA correspondente.

Estados

Default · Hover · Focus-visible · Pressed/Active quando aplicável · Disabled · Loading quando aplicável.

Motion

TriggerPropertyDurationEasing
Hoverbackground/transform100msstandard
Focusoutline/box-shadow100msstandard
Enter/Exitopacity/transform160msstandard

Respeitar prefers-reduced-motion.

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

Props

PropTipoDefaultDescrição
modelValuestring | number——
stepsVStepperStep[]——
disabledbooleanfalse—
loadingbooleanfalse—
sizeVStepperSize"md"—
variantVStepperVariant"default"—
ariaLabelstring——

Events

EventoPayloadDescrição
@update:modelValuevalue: string | number—
@step-clickstep: VStepperStep—

Slots

Sem slots.

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