Stepper
The Stepper component displays a wizard-like workflow by guiding users through the multi-step progression.
Download #
npx volt-vue add Stepper StepList Step StepPanels StepPanel StepItem
Import #
import Stepper from '@/volt/Stepper.vue';
import StepList from '@/volt/tabs/steplist';
import Step from '@/volt/tabs/step';
import StepPanels from '@/volt/tabs/steppanels';
import StepPanel from '@/volt/tabs/steppanel';
import StepItem from '@/volt/tabs/stepitem';
Horizontal #
Stepper consists of a combination of StepList, Step, StepPanels and StepPanel components. The value property is essential for associating Step and StepPanel with each other.
Content I
<template>
<div class="card flex justify-center">
<Stepper value="1" class="basis-[50rem]">
<StepList>
<Step value="1">Header I</Step>
<Step value="2">Header II</Step>
<Step value="3">Header III</Step>
</StepList>
<StepPanels>
<StepPanel v-slot="{ activateCallback }" value="1">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content I</div>
</div>
<div class="flex pt-6 justify-end">
<Button label="Next" icon="pi pi-arrow-right" iconPos="right" @click="activateCallback('2')" />
</div>
</StepPanel>
<StepPanel v-slot="{ activateCallback }" value="2">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content II</div>
</div>
<div class="flex pt-6 justify-between">
<SecondaryButton label="Back" icon="pi pi-arrow-left" @click="activateCallback('1')" />
<Button label="Next" icon="pi pi-arrow-right" iconPos="right" @click="activateCallback('3')" />
</div>
</StepPanel>
<StepPanel v-slot="{ activateCallback }" value="3">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content III</div>
</div>
<div class="pt-6">
<SecondaryButton label="Back" icon="pi pi-arrow-left" @click="activateCallback('2')" />
</div>
</StepPanel>
</StepPanels>
</Stepper>
</div>
</template>
<script setup lang="ts">
import Button from '@/volt/Button.vue';
import SecondaryButton from '@/volt/SecondaryButton.vue';
import Stepper from '@/volt/Stepper.vue';
import Step from '@/volt/Step.vue';
import StepList from '@/volt/StepList.vue';
import StepPanel from '@/volt/StepPanel.vue';
import StepPanels from '@/volt/StepPanels.vue';
</script>
Vertical #
Vertical layout requires StepItem as a wrapper of Step and StepPanel components.
Content I
<template>
<div class="card">
<Stepper value="1">
<StepItem value="1">
<Step>Header I</Step>
<StepPanel v-slot="{ activateCallback }">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content I</div>
</div>
<div class="py-6">
<Button label="Next" @click="activateCallback('2')" />
</div>
</StepPanel>
</StepItem>
<StepItem value="2">
<Step>Header II</Step>
<StepPanel v-slot="{ activateCallback }">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content II</div>
</div>
<div class="flex py-6 gap-2">
<SecondaryButton label="Back" @click="activateCallback('1')" />
<Button label="Next" @click="activateCallback('3')" />
</div>
</StepPanel>
</StepItem>
<StepItem value="3">
<Step>Header III</Step>
<StepPanel v-slot="{ activateCallback }">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content III</div>
</div>
<div class="py-6">
<SecondaryButton label="Back" @click="activateCallback('2')" />
</div>
</StepPanel>
</StepItem>
</Stepper>
</div>
</template>
<script setup lang="ts">
import Button from '@/volt/Button.vue';
import SecondaryButton from '@/volt/SecondaryButton.vue';
import Stepper from '@/volt/Stepper.vue';
import Step from '@/volt/Step.vue';
import StepItem from '@/volt/StepItem.vue';
import StepPanel from '@/volt/StepPanel.vue';
</script>
Linear #
When linear property is present, current step must be completed in order to move to the next step.
Content I
<template>
<div class="card flex justify-center">
<Stepper value="1" linear class="basis-[50rem]">
<StepList>
<Step value="1">Header I</Step>
<Step value="2">Header II</Step>
<Step value="3">Header III</Step>
</StepList>
<StepPanels>
<StepPanel v-slot="{ activateCallback }" value="1">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content I</div>
</div>
<div class="flex pt-6 justify-end">
<Button label="Next" icon="pi pi-arrow-right" @click="activateCallback('2')" />
</div>
</StepPanel>
<StepPanel v-slot="{ activateCallback }" value="2">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content II</div>
</div>
<div class="flex pt-6 justify-between">
<SecondaryButton label="Back" icon="pi pi-arrow-left" @click="activateCallback('1')" />
<Button label="Next" icon="pi pi-arrow-right" iconPos="right" @click="activateCallback('3')" />
</div>
</StepPanel>
<StepPanel v-slot="{ activateCallback }" value="3">
<div class="flex flex-col h-48">
<div class="border-2 border-dashed border-surface-200 dark:border-surface-700 rounded bg-surface-50 dark:bg-surface-950 flex-auto flex justify-center items-center font-medium">Content III</div>
</div>
<div class="pt-6">
<SecondaryButton label="Back" icon="pi pi-arrow-left" @click="activateCallback('2')" />
</div>
</StepPanel>
</StepPanels>
</Stepper>
</div>
</template>
<script setup lang="ts">
import Button from '@/volt/Button.vue';
import SecondaryButton from '@/volt/SecondaryButton.vue';
import Stepper from '@/volt/Stepper.vue';
import Step from '@/volt/Step.vue';
import StepList from '@/volt/StepList.vue';
import StepPanel from '@/volt/StepPanel.vue';
import StepPanels from '@/volt/StepPanels.vue';
</script>
Steps Only #
Use Stepper with a StepList only for custom requirements where a progress indicator is needed.
<template>
<div class="card flex justify-center">
<Stepper value="1" class="basis-[50rem]">
<StepList>
<Step value="1">Design</Step>
<Step value="2">Development</Step>
<Step value="3">QA</Step>
</StepList>
</Stepper>
</div>
</template>
<script setup lang="ts">
import Stepper from '@/volt/Stepper.vue';
import Step from '@/volt/Step.vue';
import StepList from '@/volt/StepList.vue';
</script>
Template #
Custom content for a step is defined with the default slot. The optional as property controls the default container element of a step, for example setting it to a button renders a button for the header instead of a div. The asChild option enables the headless mode for further customization by passing callbacks and properties to implement your own step.
<template>
<div class="card flex justify-center">
<Stepper v-model:value="activeStep" class="basis-[40rem]">
<StepList>
<Step v-slot="{ activateCallback, value, a11yAttrs }" asChild :value="1">
<div class="flex flex-row flex-auto gap-2" v-bind="a11yAttrs.root">
<button class="bg-transparent border-0 inline-flex flex-col gap-2" @click="activateCallback" v-bind="a11yAttrs.header">
<span
:class="[
'rounded-full border-2 w-12 h-12 inline-flex items-center justify-center',
{ 'bg-primary text-primary-contrast border-primary': value <= activeStep, 'border-surface-200 dark:border-surface-700': value > activeStep }
]"
>
<i class="pi pi-user" />
</span>
</button>
<Divider />
</div>
</Step>
<Step v-slot="{ activateCallback, value, a11yAttrs }" asChild :value="2">
<div class="flex flex-row flex-auto gap-2 pl-2" v-bind="a11yAttrs.root">
<button class="bg-transparent border-0 inline-flex flex-col gap-2" @click="activateCallback" v-bind="a11yAttrs.header">
<span
:class="[
'rounded-full border-2 w-12 h-12 inline-flex items-center justify-center',
{ 'bg-primary text-primary-contrast border-primary': value <= activeStep, 'border-surface-200 dark:border-surface-700': value > activeStep }
]"
>
<i class="pi pi-star" />
</span>
</button>
<Divider />
</div>
</Step>
<Step v-slot="{ activateCallback, value, a11yAttrs }" asChild :value="3">
<div class="flex flex-row pl-2" v-bind="a11yAttrs.root">
<button class="bg-transparent border-0 inline-flex flex-col gap-2" @click="activateCallback" v-bind="a11yAttrs.header">
<span
:class="[
'rounded-full border-2 w-12 h-12 inline-flex items-center justify-center',
{ 'bg-primary text-primary-contrast border-primary': value <= activeStep, 'border-surface-200 dark:border-surface-700': value > activeStep }
]"
>
<i class="pi pi-id-card" />
</span>
</button>
</div>
</Step>
</StepList>
<StepPanels>
<StepPanel v-slot="{ activateCallback }" :value="1">
<form @submit.prevent>
<div class="flex flex-col gap-4 mx-auto" style="min-height: 16rem; max-width: 20rem">
<div class="text-center mt-4 mb-4 text-xl font-semibold">Create your account</div>
<div class="field">
<InputText v-model="name" type="text" placeholder="Name" fluid autocomplete="off" />
</div>
<div class="field">
<InputText v-model="email" type="email" placeholder="Email" fluid autocomplete="off" />
</div>
<div class="field">
<Password v-model="password" placeholder="Password" fluid :inputProps="{ autocomplete: 'new-password' }" />
</div>
</div>
<div class="flex pt-6 justify-end">
<Button label="Next" icon="pi pi-arrow-right" iconPos="right" @click="activateCallback(2)" />
</div>
</form>
</StepPanel>
<StepPanel v-slot="{ activateCallback }" :value="2">
<div class="flex flex-col gap-2 mx-auto" style="min-height: 16rem; max-width: 24rem">
<div class="text-center mt-4 mb-4 text-xl font-semibold">Choose your interests</div>
<div class="flex flex-wrap justify-center gap-4">
<ToggleButton v-model="option1" onLabel="Nature" offLabel="Nature" />
<ToggleButton v-model="option2" onLabel="Art" offLabel="Art" />
<ToggleButton v-model="option3" onLabel="Music" offLabel="Music" />
<ToggleButton v-model="option4" onLabel="Design" offLabel="Design" />
<ToggleButton v-model="option5" onLabel="Photography" offLabel="Photography" />
<ToggleButton v-model="option6" onLabel="Movies" offLabel="Movies" />
<ToggleButton v-model="option7" onLabel="Sports" offLabel="Sports" />
<ToggleButton v-model="option8" onLabel="Gaming" offLabel="Gaming" />
<ToggleButton v-model="option9" onLabel="Traveling" offLabel="Traveling" />
<ToggleButton v-model="option10" onLabel="Dancing" offLabel="Dancing" />
</div>
</div>
<div class="flex pt-6 justify-between">
<SecondaryButton label="Back" icon="pi pi-arrow-left" @click="activateCallback(1)" />
<Button label="Next" icon="pi pi-arrow-right" iconPos="right" @click="activateCallback(3)" />
</div>
</StepPanel>
<StepPanel v-slot="{ activateCallback }" :value="3">
<div class="flex flex-col gap-2 mx-auto" style="min-height: 16rem; max-width: 24rem">
<div class="text-center mt-4 mb-4 text-xl font-semibold">Account created successfully</div>
<div class="flex justify-center">
<img alt="logo" src="https://primefaces.org/cdn/primevue/images/stepper/content.svg" />
</div>
</div>
<div class="flex pt-6 justify-start">
<SecondaryButton label="Back" icon="pi pi-arrow-left" @click="activateCallback(2)" />
</div>
</StepPanel>
</StepPanels>
</Stepper>
</div>
</template>
<script setup lang="ts">
import Button from '@/volt/Button.vue';
import SecondaryButton from '@/volt/SecondaryButton.vue';
import Divider from '@/volt/Divider.vue';
import InputText from '@/volt/InputText.vue';
import Password from '@/volt/Password.vue';
import Stepper from '@/volt/Stepper.vue';
import Step from '@/volt/Step.vue';
import StepList from '@/volt/StepList.vue';
import StepPanel from '@/volt/StepPanel.vue';
import StepPanels from '@/volt/StepPanels.vue';
import ToggleButton from '@/volt/ToggleButton.vue';
import { ref } from 'vue';
const activeStep = ref(1);
const name = ref();
const email = ref();
const password = ref();
const option1 = ref(false);
const option2 = ref(false);
const option3 = ref(false);
const option4 = ref(false);
const option5 = ref(false);
const option6 = ref(false);
const option7 = ref(false);
const option8 = ref(false);
const option9 = ref(false);
const option10 = ref(false);
</script>