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/carousel.md

View on GitHub
- [Carousel (`<elvia-carousel>`)](#carousel-elvia-carousel)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Attributes](#attributes)
    - [items](#items)
    - [type](#type)
    - [hasConfirmationCheckmark](#hasconfirmationcheckmark)
    - [onFinish](#onfinish)
    - [value](#value)
    - [valueOnChange](#valueonchange)
    - [hasAnimation](#hasanimation)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Carousel (`<elvia-carousel>`)

## Reference

https://design.elvia.io/components/carousel#Overview

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

## Installation

Install `@elvia/elvis-carousel`. See [Elvis Installation](./installation.md).

## Use

Add one `item-N` slot for each item. Number slots from 1 without gaps. Add `heading-N` slots when needed.

```html
<elvia-carousel>
  <div slot="heading-1">
    <h3 class="e-title-sm">Er strømbruddet kun hos deg?</h3>
  </div>
  <div slot="item-1">
    <img alt="" src="/assets/carousel/el1.jpeg" />
  </div>
  <div slot="heading-2">
    <h3 class="e-title-sm">Har flere mistet strømmen?</h3>
  </div>
  <div slot="item-2">
    <img alt="" src="/assets/carousel/el2.jpeg" />
  </div>
  <div slot="heading-3">
    <h3 class="e-title-sm">Vær forberedt på strømbrudd</h3>
  </div>
  <div slot="item-3">
    <img alt="" src="/assets/carousel/el3.jpeg" />
  </div>
</elvia-carousel>
```

You can also set `items` to a number. This shows the navigation only. Add your own item content and transition
animation.

## Attributes

### items

Use numbered `item-N` and optional `heading-N` slots, or set `items` to a number to show navigation without
content.

```html
<elvia-carousel items="3"></elvia-carousel>
```

### type

Allowed values are `loop` and `linear`. The default is `loop`. Set `linear` to stop at the first and last
items.

```html
<elvia-carousel type="linear"></elvia-carousel>
```

### hasConfirmationCheckmark

Set this to `true` with `type="linear"` to replace the last next button with a confirmation button.

```html
<elvia-carousel type="linear" hasconfirmationcheckmark></elvia-carousel>
```

### onFinish

Listen for this event when the user selects the confirmation button. It requires `type="linear"` and
`hasConfirmationCheckmark`.

```js
carousel.addEventListener('onFinish', () => {
  closeDialog();
});
```

### value

The selected item index starts at `0`. Set this property to select an item.

```js
carousel.value = 1;
```

### valueOnChange

Listen for this event to get the selected item index. See [Web components](./web-components.md).

```js
carousel.addEventListener('valueOnChange', (event) => {
  console.log(event.detail.value);
});
```

### hasAnimation

The default is `true`. Set this to `false` to disable transitions between items.

```html
<elvia-carousel hasAnimation="false"></elvia-carousel>
```

## Guidelines

### When to use

- Use a carousel for a visual collection when users need to focus on a few items at a time.
- Use a carousel for a collection of related items.

### When not to use

- Do not use a carousel for non-visual items, such as links or paragraphs.
- Do not use a carousel for form split in multiple steps. Use [Stepper](./stepper.md) instead.
- Use a [list](./list.md) instead of a carousel with more than five items.

## Accessibility

- Use the left and right arrow keys to navigate the controls and pages.
- Use Space or Enter to select a page.

## Examples

**Input:** Show three related images with headings.

**Output:**

```html
<elvia-carousel>
  <div slot="heading-1">
    <h3 class="e-title-sm">Er strømbruddet kun hos deg?</h3>
  </div>
  <div slot="item-1">
    <img alt="" src="/assets/carousel/el1.jpeg" />
  </div>
  <div slot="heading-2">
    <h3 class="e-title-sm">Har flere mistet strømmen?</h3>
  </div>
  <div slot="item-2">
    <img alt="" src="/assets/carousel/el2.jpeg" />
  </div>
  <div slot="heading-3">
    <h3 class="e-title-sm">Vær forberedt på strømbrudd</h3>
  </div>
  <div slot="item-3">
    <img alt="" src="/assets/carousel/el3.jpeg" />
  </div>
</elvia-carousel>
```

**Input:** Close a dialog after the user confirms the last onboarding step.

**Output:**

```html
<elvia-carousel type="linear" hasconfirmationcheckmark>
  <div slot="item-1">Velkommen.</div>
  <div slot="item-2">Du er klar til å begynne.</div>
</elvia-carousel>
```

```js
carousel.addEventListener('onFinish', () => {
  closeDialog();
});
```
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