Skip to content

Stepper

Horizontal step indicator with dots, checkmarks, connecting lines. Guides users through multi-step flows.

Demo

Standard

  1. KontaktinfoNavn og email
  2. AdresseLeveringsadresse
  3. BetalingBetalingsmetode
  4. Opsummering

Alle klikbare

  1. KontaktinfoNavn og email
  2. AdresseLeveringsadresse
  3. BetalingBetalingsmetode
  4. Opsummering

Med fejl

  1. Kontaktinfo
  2. Adresse
  3. Betaling

Simpel

Trin 1 af 4

Installation

vue
<script setup>
import { GTStepper } from '@grundtone/vue';
</script>

In Nuxt, GTStepper is auto-imported.

Usage

Basic

vue
<script setup>
const step = ref(0);
const steps = [
  { label: 'Kontaktinfo' },
  { label: 'Adresse' },
  { label: 'Betaling' },
  { label: 'Opsummering' },
];
</script>

<GTStepper v-model:active-step="step" :steps="steps" />

All steps clickable

vue
<GTStepper v-model:active-step="step" :steps="steps" all-clickable />

With info text

vue
<GTStepper :steps="[
  { label: 'Kontakt', info: 'Navn og email' },
  { label: 'Adresse', info: 'Leveringsadresse' },
]" />

With error

vue
<GTStepper :steps="[
  { label: 'Kontakt', error: true },
  { label: 'Adresse' },
]" :active-step="1" />

Simple variant

vue
<GTStepper :steps="steps" :active-step="1" simple />
<!-- Renders: "Trin 2 af 4" -->

<GTStepper :steps="steps" :active-step="0" simple simple-label="Step {current} of {total}" />
<!-- Renders: "Step 1 of 4" -->

Props

PropTypeDefaultDescription
stepsStepperStep[]Steps config (required)
activeStepnumber0Active step index (v-model)
allClickablebooleanfalseAll steps navigable
simplebooleanfalseSimple "Trin X af Y" text
simpleLabelstring'Trin {current} af {total}'Template for simple variant

StepperStep

PropertyTypeDescription
labelstringStep label
infostringExtra info below label
errorbooleanError state

Events

EventPayloadDescription
update:activeStepnumberStep clicked

Accessibility

  • Ordered list <ol> with aria-current="step" on active
  • Completed steps are clickable, upcoming are disabled
  • Error steps visually distinct

See Stepper (Design System) for full CSS reference.