3lvia/designsystem / skills/elvia-design-system
elvia-design-system
VerifiedReference 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").
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();
});
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |