Gå til innholdet

Ikon (Icon)

<adb-icon> rendrer ikoner som inline SVG. Ikoner arver tekstfarge via currentColor, og dekorative ikoner skjules automatisk for skjermlesere.

Se Ikonoversikt for alle tilgjengelige ikoner.

Eksempler

<!-- Dekorativt (aria-hidden="true" settes automatisk) -->
<adb-icon name="search"></adb-icon>
<!-- Meningsbærende (role="img" + aria-label settes automatisk) -->
<adb-icon name="search" label="Søk"></adb-icon>

Størrelser

<adb-icon name="search" size="sm"></adb-icon> <!-- 16px -->
<adb-icon name="search" size="md"></adb-icon> <!-- 24px (standard) -->
<adb-icon name="search" size="lg"></adb-icon> <!-- 24px (samme som md) -->
sm
md
lg

Farger

Ikoner arver color fra omgivelsene. Sett CSS color-egenskapen på <adb-icon> eller en overordnet element:

<adb-icon name="close" style="color: var(--adb-alert-danger-text-primary)"></adb-icon>

Bruk i knapper

Kombiner med <adb-button> via slots:

<adb-button variant="primary" color="accent">
<adb-icon slot="icon-start" name="search"></adb-icon>
Søk
</adb-button>

Eller med <adb-icon-button> for et rent ikonknapp:

<adb-icon-button aria-label="Søk">
<adb-icon name="search"></adb-icon>
</adb-icon-button>

Bruk uten web component

Trenger du bare SVG-en, f.eks. i en kartmarkør eller et eget Angular/React-komponent, importer den som tekst fra @artsdatabanken/icons/svg. Importen har ingen sideeffekter, og bundleren tar bare med ikonene du bruker. Eksportnavnet er icon + ikonnavnet i PascalCase (arrow-back → iconArrowBack, license/by → iconLicenseBy).

import { iconSearch, iconLicenseBy } from '@artsdatabanken/icons/svg';
element.innerHTML = iconSearch;

I Angular fjerner [innerHTML] <svg>-elementer — bruk DomSanitizer.bypassSecurityTrustHtml(iconSearch).

SVG-filene finnes også som filer, med samme sti som ikonnavnet:

{{ source('@artsdatabanken/icons/svg/search.svg') }}
{{ source('@artsdatabanken/icons/svg/license/by.svg') }}

Legge til ikoner

  1. Eksporter fra Figma som SVG (24×24 px artboard)
  2. Navngi filen etter «GMI Navn» i Figma, i lowercase-kebab-case — f.eks. arrow-forward.svg
  3. Legg den i packages/icons/src/svg/ — modifiserte ikoner i custom/, lisensikoner i license/. Ikonnavnet blir da f.eks. custom/sparkle eller license/by.
  4. Kjør npm run build:icons -w @artsdatabanken/icons
  5. Commit både SVG-filen og den oppdaterte src/generated/icons.ts

API

Attributter

AttributtTypeStandardBeskrivelse
namestring—Ikonnavn — samsvarer med filnavn i src/svg/ uten .svg
size'sm' | 'md' | 'lg''md'Størrelse: 16 / 24 / 24 px (lg er lik md, tilpasset <adb-icon-button>)
labelstring—Aria-label. Sett for meningsbærende ikoner; utelat for dekorative.

CSS Custom Properties

EgenskapStandardBeskrivelse
--adb-icon-sizeavhenger av sizeOverstyr størrelse direkte

Universell utforming (WCAG 2.1 AA)

ScenarioAnbefalt bruk
Ikon med synlig tekst ved siden avUtelat label — ikonet er dekorativt
Frittstående ikon uten tekstSett label med en beskrivende tekst, f.eks. label="Lukk dialog"
Ikon i <adb-icon-button>Sett aria-label på knappen — utelat label på ikonet

Tommelfingerregel: Tekst er primær, ikon er dekorativt med mindre ikonet er den eneste affordansen.