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.