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/link.md
View on GitHub- [Link (`e-link`)](#link-e-link)
- [Reference](#reference)
- [Installation](#installation)
- [Use](#use)
- [Guidelines](#guidelines)
- [When to use](#when-to-use)
- [When not to use](#when-not-to-use)
- [Types](#types)
- [Size](#size)
- [Label](#label)
- [Links with button style](#links-with-button-style)
- [Accessibility](#accessibility)
- [Examples](#examples)
- [Classes](#classes)
# Link (`e-link`)
## Reference
https://design.elvia.io/components/link
Link is a CSS-based component. It uses CSS classes only.
## Installation
Install `@elvia/elvis` to use this CSS-based component. Follow the
[Elvis installation reference](./installation.md) for setup.
Links with icons use the `<e-icon>` web component. Read the [icon reference](./icon.md) for setup and icon
names.
## Use
```html
<a class="e-link" href="/outages">Se vårt strømbruddskart</a>
```
## Guidelines
### When to use
- Use the application's routing mechanism for in-app navigation.
- Apply `e-link` to the rendered link.
### When not to use
- The component has no disabled modifier. Explain unavailable destinations in text.
- Use a button when the user changes application state.
### Types
- **Standard** (`e-link`): standalone navigation.
- **Inline** (`e-link--inline`): inherits the surrounding font size.
- **New tab** (`e-link--new-tab`): apply to external links that open in a new tab. Set `target="_blank"`. Set
`rel="noopener"`.
- **Action** (`e-link--action`): prominent navigation with a trailing arrow icon.
- **Back** (`e-link--back`): navigation to a previous or parent page with a leading arrow icon.
- Use `e-link__title` and `e-link__icon` in action and back links. Include both color and filled icons to show
hover and active states.
### Size
- Small `e-link--sm`.
- Medium `e-link--md` (default).
- Large `e-link--lg`.
### Label
Use concise labels that describe the destination. Do not use labels such as “click here.”
### Links with button style
Use `e-btn` on a link only when navigation needs button styling.
```html
<a class="e-btn" href="/application-details">
<span class="e-btn__title">Se systemdetaljer</span>
</a>
```
## Accessibility
- An icon alone does not tell users that a link opens a new tab. State this in the link text or nearby text.
## Examples
**Input:** Open the outage map in a new tab.
**Output:**
```html
<a class="e-link e-link--new-tab" href="https://strombruddskart.elvia.no/" target="_blank" rel="noopener">
<span class="e-link__title"
>Se vårt strømbruddskart <span class="e-sr-only">(åpnes i en ny fane)</span></span
>
<span class="e-link__icon">
<e-icon name="newTabBold"></e-icon>
</span>
</a>
```
**Input:** Add an action link with an arrow icon.
**Output:**
```html
<a class="e-link e-link--action" href="/systems">
<span class="e-link__title">Se systemer</span>
<span class="e-link__icon">
<e-icon name="arrowRightCircleColor"></e-icon>
<e-icon name="arrowRightCircleFilledColor"></e-icon>
</span>
</a>
```
## Classes
Classes use BEM.
Base: `e-link`
**Elements**
- `e-link__icon`
- `e-link__title`
**Modifiers**
- `e-link--action`
- `e-link--back`
- `e-link--inline`
- `e-link--lg`
- `e-link--md`
- `e-link--new-tab`
- `e-link--sm`
**Pseudos**
- `e-link---focus`
- `e-link---hover`
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 |