Skip to content

3lvia/designsystem / skills/elvia-design-system

elvia-design-system

Verified

Reference for UI components and patterns in Elvia's design system ("Elvis"). Covers component- and pattern-specific guidelines for sizing, color tokens for custom UI, types, ordering, labeling, accessibility attributes, CSS setup, and web-component registration. Use when building, reviewing, or fixing UI in an Elvia frontend, even if the request doesn't name Elvia or the CSS classes explicitly (e.g. "add a save button", "make this icon bigger", "add a tooltip").

FileKindSize
README.mdmarkdown726 B
SKILL.mdskill md10.4 KB
references/accordion.mdmarkdown5.9 KB
references/alert.mdmarkdown4.3 KB
references/app-bridge.mdmarkdown3.3 KB
references/autocomplete.mdmarkdown5.5 KB
references/badge.mdmarkdown2.3 KB
references/box.mdmarkdown2.0 KB
references/breadcrumb.mdmarkdown2.9 KB
references/button.mdmarkdown6.0 KB
references/card.mdmarkdown5.6 KB
references/carousel.mdmarkdown4.4 KB
references/checkbox.mdmarkdown4.7 KB
references/chip.mdmarkdown4.1 KB
references/color-tokens.mdmarkdown5.6 KB
references/content-loader.mdmarkdown2.0 KB
references/context-menu.mdmarkdown6.6 KB
references/data-formats.mdmarkdown2.1 KB
references/datepicker-range.mdmarkdown5.4 KB
references/datepicker.mdmarkdown6.0 KB
references/divider.mdmarkdown2.4 KB
references/drag-and-drop.mdmarkdown2.0 KB
references/dropdown.mdmarkdown6.7 KB
references/empty-state.mdmarkdown3.0 KB
references/file-upload.mdmarkdown2.6 KB
references/form-field.mdmarkdown2.7 KB
references/header.mdmarkdown5.8 KB
references/icon.mdmarkdown5.0 KB
references/illustrations.mdmarkdown1.4 KB
references/input.mdmarkdown2.5 KB
references/installation.mdmarkdown2.1 KB
references/link.mdmarkdown3.3 KB
references/list.mdmarkdown2.0 KB
references/modal.mdmarkdown6.1 KB
references/pagination.mdmarkdown4.0 KB
references/popover.mdmarkdown5.3 KB
references/progress-linear.mdmarkdown3.1 KB
references/radio-button.mdmarkdown2.6 KB
references/radio-filter.mdmarkdown2.8 KB
references/search-pattern.mdmarkdown2.7 KB
references/segmented-control.mdmarkdown3.9 KB
references/shadows.mdmarkdown1.3 KB
references/slider.mdmarkdown3.6 KB
references/stepper.mdmarkdown4.7 KB
references/table.mdmarkdown8.4 KB
references/tabs.mdmarkdown3.8 KB
references/tag.mdmarkdown5.0 KB
references/thumbnail.mdmarkdown1.9 KB
references/timepicker.mdmarkdown5.1 KB
references/toast.mdmarkdown3.4 KB
references/toggle.mdmarkdown2.1 KB
references/tooltip.mdmarkdown4.1 KB
references/typography.mdmarkdown3.3 KB
references/utility-classes.mdmarkdown3.9 KB
references/web-components.mdmarkdown2.1 KB

references/stepper.md

View on GitHub
- [Stepper (`<elvia-stepper>`)](#stepper-elvia-stepper)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Attributes](#attributes)
    - [type](#type)
    - [steps](#steps)
    - [isForced](#isforced)
    - [removeActions](#removeactions)
    - [typography](#typography)
    - [value](#value)
    - [valueOnChange](#valueonchange)
    - [onFinish](#onfinish)
    - [onNextClick](#onnextclick)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Stepper (`<elvia-stepper>`)

## Reference

https://design.elvia.io/components/stepper

`<elvia-stepper>` is a web component.

## Installation

This web component requires the `@elvia/elvis-stepper` package. If it is not installed, follow the
[Installation reference](./installation.md).

## Use

Place one child per step inside an element with `slot="content"`. Step indexes start at `1`.

```html
<elvia-stepper>
  <div slot="content">
    <div>Trinn 1 innhold</div>
    <div>Trinn 2 innhold</div>
    <div>Trinn 3 innhold</div>
  </div>
</elvia-stepper>
```

## Attributes

### type

Allowed values are `horizontal` and `vertical`. The default is `horizontal`. Set `type` to `vertical` to stack
the steps. Example:

```html
<elvia-stepper type="vertical">
  <div slot="content">
    <div>Trinn 1</div>
    <div>Trinn 2</div>
    <div>Trinn 3</div>
  </div>
</elvia-stepper>
```

### steps

Pass an object keyed by one-based step indexes. Each entry can set `heading`, `isCompleted`, `isError`,
`nextButtonText`, `previousButtonText`, or `nextButtonState`. Set `nextButtonState` to `loading` to show a
loading state on the next button. Default button text follows the page language. Example:

```js
document.querySelector('elvia-stepper').steps = {
  1: { heading: 'Kontaktopplysninger' },
  2: { heading: 'Kontroll' },
  3: { heading: 'Bekreftelse', nextButtonText: 'Send inn' },
};
```

### isForced

A boolean. The default is `false`. Set it to `true` to block forward navigation until the current step is
complete. Example:

```html
<elvia-stepper isForced>
  <div slot="content">
    <div>Trinn 1</div>
    <div>Trinn 2</div>
    <div>Trinn 3</div>
  </div>
</elvia-stepper>
```

### removeActions

A boolean. The default is `false`. Set it to `true` to hide the next and previous buttons. Example:

```html
<elvia-stepper removeActions>
  <div slot="content">
    <div>Trinn 1</div>
    <div>Trinn 2</div>
    <div>Trinn 3</div>
  </div>
</elvia-stepper>
```

### typography

Set a typography name for step headings. See [Typography](./typography.md). Example:

```html
<elvia-stepper typography="text-md">
  <div slot="content">
    <div>Trinn 1</div>
    <div>Trinn 2</div>
    <div>Trinn 3</div>
  </div>
</elvia-stepper>
```

### value

The active step index starts at `1`. The default is `1`. Set this property to control the active step.

### valueOnChange

Fires when the active step changes. Read the new one-based index from `event.detail.value`. See
[Events](./web-components.md#events).

### onFinish

Fires when the user selects the next button on the final step.

### onNextClick

Fires when the user selects the next button, even when forced progression blocks the next step.

## Guidelines

### When to use

- Use a stepper for a process with clear stages and a need to show progress or navigation.
- Use forced progression when each step must be complete before the user continues.
- Use normal progression when users can navigate between steps.

### When not to use

- Do not use stepper for processes with fewer than three or more than ten steps.
- Do not use stepper for a list or a process without step-by-step navigation.

## Accessibility

- The component sets `tablist`, `tab`, `tabpanel`, `aria-selected`, and a polite live status region.
- Use Left and Right Arrow keys for horizontal steps. Use Up and Down Arrow keys for vertical steps.
- Use Home and End to focus the first or last step. Press Enter or Space to select a focused step.

## Examples

**Input:** Create a three-step meter registration flow.

**Output:**

```html
<elvia-stepper>
  <div slot="content">
    <section>Legg inn målepunkt-ID.</section>
    <section>Kontroller opplysningene.</section>
    <section>Send inn registreringen.</section>
  </div>
</elvia-stepper>
<p id="registration-status" aria-live="polite"></p>
```

```js
const stepper = document.querySelector('elvia-stepper');
stepper.steps = {
  1: { heading: 'Målepunkt' },
  2: { heading: 'Kontroll' },
  3: { heading: 'Bekreftelse', nextButtonText: 'Send inn' },
};
stepper.addEventListener('onFinish', () => {
  document.querySelector('#registration-status').textContent = 'Registreringen er sendt.';
});
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall