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/context-menu.md

View on GitHub
- [Context Menu (`<elvia-context-menu>`)](#context-menu-elvia-context-menu)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Attributes](#attributes)
    - [content](#content)
    - [horizontalPosition](#horizontalposition)
    - [verticalPosition](#verticalposition)
    - [isSelectable](#isselectable)
    - [isShowing](#isshowing)
    - [display](#display)
    - [anchorPosition](#anchorposition)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Context Menu (`<elvia-context-menu>`)

## Reference

https://design.elvia.io/components/context-menu

`<elvia-context-menu>` is a web component.

## Installation

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

## Use

- Put the trigger in a child with `slot="trigger"`.
- Put menu items in a child with `slot="content"`.
- Use a native `<button>` as the trigger. Set `aria-haspopup="menu"` on it. See [Buttons](./button.md).
- Use `<e-icon>` for icons beside menu actions. See [Icons](./icon.md).
- Wrap related items in `ewc-context-menu__list-group` to separate them. Add a heading inside a group when
  needed.
- The menu closes when a user selects an item, clicks outside it, or presses Escape.
- Listen for `onOpen` and `onClose` with `addEventListener`. See [Web Components](./web-components.md) for
  event behavior.

```html
<elvia-context-menu>
  <button aria-haspopup="menu" slot="trigger" aria-label="Flere handlinger" class="e-btn e-btn--icon">
    <span class="e-btn__icon">
      <e-icon name="moreMenu"> </e-icon>
    </span>
  </button>
  <div slot="content" class="ewc-context-menu__list-group">
    <button role="menuitem">Rediger</button>
    <button role="menuitem">Slett</button>
  </div>
</elvia-context-menu>
```

## Attributes

### content

Use `slot="content"` for menu items or other elements.

```html
<elvia-context-menu>
  <button aria-haspopup="menu" slot="trigger" aria-label="Flere handlinger" class="e-btn e-btn--icon">
    <span class="e-btn__icon">
      <e-icon name="moreMenu"> </e-icon>
    </span>
  </button>
  <div slot="content">
    <div class="ewc-context-menu__list-group">
      <button role="menuitem">Be om tilgang</button>
      <button role="menuitem">Legg til bruker</button>
      <button role="menuitem">Fjern bruker</button>
    </div>
    <div class="ewc-context-menu__list-group">
      <a role="menuitem" href="#">Endre passord</a>
      <button role="menuitem">Innstillinger</button>
    </div>
  </div>
</elvia-context-menu>
```

### horizontalPosition

Set it to `"left"` or `"right"`. It defaults to `"left"`.

```html
<elvia-context-menu horizontalPosition="right">...</elvia-context-menu>
```

### verticalPosition

Set it to `"bottom"` or `"top"`. It defaults to `"bottom"`.

```html
<elvia-context-menu verticalPosition="top">...</elvia-context-menu>
```

### isSelectable

Defaults to `false`. Set it to `true` for a menu of mutually exclusive choices.

```html
<elvia-context-menu isSelectable="true">...</elvia-context-menu>
```

### isShowing

Defaults to `false`. Set it to `true` to show the menu.

```html
<elvia-context-menu isShowing>...</elvia-context-menu>
```

### display

Sets the trigger container's CSS `display` value. It defaults to `"inline-block"`. Change it if this value
conflicts with the surrounding layout.

```html
<elvia-context-menu display="block">...</elvia-context-menu>
```

### anchorPosition

Set an object with `top` and `left` pixel coordinates to position the menu at a point. It can then be used as
a custom context menu anywhere on the page when right-clicked.

```js
const menu = document.querySelector('elvia-context-menu');
menu.anchorPosition = { top: 100, left: 200 };
```

## Guidelines

### When to use

- Show a short list of secondary actions beside a trigger.
- Use `isSelectable` for a list where the user selects one option.

### When not to use

- Do not use this menu for supporting information. Use a [Popover](./popover.md).
- Do not add many options. The menu can overwhelm users on mobile.

## Accessibility

- Add `role="menuitem"` to each regular menu item.
- For selectable menus, add `role="menuitemradio"` and `aria-checked` to each item.
- Add `e-btn---selected` to the trigger while the menu is open.

## Examples

**Input:** "Show icons beside known actions."

**Output:**

```html
<elvia-context-menu>
  <button slot="trigger" class="e-btn e-btn--icon" aria-haspopup="menu" aria-label="Flere handlinger">
    <span class="e-btn__icon">
      <e-icon name="moreMenu"></e-icon>
    </span>
  </button>
  <div slot="content" class="ewc-context-menu__list-group">
    <button role="menuitem">
      <e-icon name="edit" size="xs"></e-icon>
      <span>Rediger</span>
    </button>
    <button role="menuitem">
      <e-icon name="bin" size="xs"></e-icon>
      <span>Slett</span>
    </button>
    <a role="menuitem" href="#">
      <e-icon name="download" size="xs"></e-icon>
      <span>Last ned</span>
    </a>
  </div>
</elvia-context-menu>
```

**Input:** "Group different actions under headings."

**Output:**

```html
<elvia-context-menu>
  <button slot="trigger" class="e-btn e-btn--icon" aria-haspopup="menu" aria-label="Flere handlinger">
    <span class="e-btn__icon">
      <e-icon name="moreMenu"></e-icon>
    </span>
  </button>
  <div slot="content">
    <div class="ewc-context-menu__list-group">
      <h1>Kundeforhold</h1>
      <button role="menuitem">Be om tilgang</button>
      <button role="menuitem">Legg til bruker</button>
    </div>
    <div class="ewc-context-menu__list-group">
      <h1>Innlogging</h1>
      <a role="menuitem" href="#">Endre passord</a>
      <a role="menuitem" href="#">To-faktor autentisering</a>
    </div>
  </div>
</elvia-context-menu>
```

**Input:** "Disable an action that is not available."

**Output:**

```html
<elvia-context-menu>
  <button slot="trigger" class="e-btn e-btn--icon" aria-haspopup="menu" aria-label="Flere handlinger">
    <span class="e-btn__icon">
      <e-icon name="moreMenu"></e-icon>
    </span>
  </button>
  <div slot="content" class="ewc-context-menu__list-group">
    <button role="menuitem">
      <e-icon name="accessControl" size="xs"></e-icon>
      <span>Be om tilgang</span>
    </button>
    <button role="menuitem" disabled>
      <e-icon name="users" size="xs" class="e-icon--color-disabled-1"></e-icon>
      <span>Legg til bruker</span>
    </button>
    <a role="menuitem" href="#">
      <e-icon name="edit" size="xs"></e-icon>
      <span>Endre passord</span>
    </a>
  </div>
</elvia-context-menu>
```
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