Navegação
VStepper
Componente VueUI Nova para **stepper**, seguindo tokens semânticos e Light Mode como referência principal.
<script setup lang="ts">
import { VStepper } 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 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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover | background/transform | 100ms | standard |
| Focus | outline/box-shadow | 100ms | standard |
| Enter/Exit | opacity/transform | 160ms | 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 | number | — | — |
steps | VStepperStep[] | — | — |
disabled | boolean | false | — |
loading | boolean | false | — |
size | VStepperSize | "md" | — |
variant | VStepperVariant | "default" | — |
ariaLabel | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: string | number | — |
@step-click | step: VStepperStep | — |
Slots
Sem slots.
Fonte: src/components/navigation/VStepper/VStepper.vue · tipos: src/components/navigation/VStepper/VStepper.types.ts