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

View on GitHub
- [Chip (`<elvia-chip>`)](#chip-elvia-chip)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Attributes](#attributes)
    - [type](#type)
    - [ariaLabel](#arialabel)
    - [color](#color)
    - [value](#value)
    - [markerStyle](#markerstyle)
    - [isLoading](#isloading)
    - [isSelected](#isselected)
    - [image](#image)
    - [onDelete](#ondelete)
    - [isSelectedOnChange](#isselectedonchange)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Chip (`<elvia-chip>`)

## Reference

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

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

## Installation

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

## Use

```html
<elvia-chip type="removable" value="2025" ariaLabel="Fjern filter: 2025"></elvia-chip>
```

Set `ariaLabel` for every chip. Use the `image` slot only with removable chips.

For updates to attributes or properties after initialization, follow the shared
[attribute and property guidance](./web-components.md#attributes-and-properties).

## Attributes

### type

Set to `removable`, `legend`, or `choice`. Defaults to `removable`.

- Use `removable` for selected filters that users can remove.
- Use `legend` to toggle data in a graph or map.
- Use `choice` to select multiple options.

### ariaLabel

Set an accessible label for every chip. Keep the label stable when the selected state changes.

### color

Set to `blue`, `green`, `orange`, `purple`, `red`, or `violet`. Defaults to `green`.

Use different colors to distinguish categories. Group chips with the same color.

For legend chips align their color with the corresponding data representation in the graph or map.

### value

Required. Set the text to display in the chip.

### markerStyle

Set to `dot`, `line`, or `dashed`. Defaults to `dot`.

Use this attribute with `type="legend"`.

### isLoading

Set this attribute to show a loading state. Use it only with `type="legend"`.

### isSelected

Set this attribute to mark a legend or choice chip as selected.

### image

Add an image to a removable chip with a child element that has `slot="image"`. The image is 32 by 32 pixels.

### onDelete

Listen for this event when a user activates a removable chip. Its event value is the chip's `value`. See
[Events](./web-components.md#events).

### isSelectedOnChange

Listen for this event when a user changes the selected state of a legend or choice chip. Its event value is
the new selected state. See [Events](./web-components.md#events).

## Guidelines

### When to use

- Use removable chips with a filter to show selected values.
- Use legend chips to toggle graph or map data.
- Use choice chips when users can select multiple options.

### When not to use

- Do not use choice chips when users must select only one option. Use [Radio buttons](./radio-button.md).

## Accessibility

- Set `ariaLabel` for every chip.
- Users can move between chips with Tab.
- Users can select, unselect, or delete a chip with Space or Enter.
- Legend and choice chips use `role="checkbox"` and `aria-checked` to indicate their selected state.
- Keep the accessible name stable when the selected state changes.

## Examples

**Input:** Remove a selected filter when a user activates its chip.

**Output:**

```html
<elvia-chip id="filter" type="removable" value="2025" ariaLabel="Forbruk for 2025"> </elvia-chip>
```

```js
const chip = document.querySelector('#filter');

chip.addEventListener('onDelete', () => {
  chip.remove();
});
```

**Input:** Label a legend chip with the name of its data series.

**Output:**

```html
<elvia-chip
  ariaLabel="Produksjon"
  color="orange"
  id="production"
  type="legend"
  value="Produksjon"
></elvia-chip>
```

**Input:** Show the person assigned to a task with an image.

**Output:**

```html
<elvia-chip type="removable" value="Ola Nordmann" ariaLabel="Fjern Ola Nordmann">
  <img slot="image" src="assets/chip/example.png" alt="" />
</elvia-chip>
```
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