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) -->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
- Eksporter fra Figma som SVG (24×24 px artboard)
- Navngi filen etter «GMI Navn» i Figma, i
lowercase-kebab-case— f.eks.arrow-forward.svg - Legg den i
packages/icons/src/svg/— modifiserte ikoner icustom/, lisensikoner ilicense/. Ikonnavnet blir da f.eks.custom/sparkleellerlicense/by. - Kjør
npm run build:icons -w @artsdatabanken/icons - Commit både SVG-filen og den oppdaterte
src/generated/icons.ts
API
Attributter
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
name | string | — | 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>) |
label | string | — | Aria-label. Sett for meningsbærende ikoner; utelat for dekorative. |
CSS Custom Properties
| Egenskap | Standard | Beskrivelse |
|---|---|---|
--adb-icon-size | avhenger av size | Overstyr størrelse direkte |
Universell utforming (WCAG 2.1 AA)
| Scenario | Anbefalt bruk |
|---|---|
| Ikon med synlig tekst ved siden av | Utelat label — ikonet er dekorativt |
| Frittstående ikon uten tekst | Sett 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.