Gå til innholdet

Temabytter (Dark Mode Toggle)

<adb-dark-mode-toggle> bytter mellom lyst og mørkt tema ved å sette data-theme på <html>. Valget lagres i localStorage, så det huskes ved neste besøk. Har brukeren ikke valgt selv, følger komponenten operativsystemets innstilling (prefers-color-scheme).

Knappen viser et månesymbol i lyst tema (bytt til mørkt) og et solsymbol i mørkt tema (bytt til lyst).

Prøv den — knappen bytter tema på hele denne siden

<adb-dark-mode-toggle></adb-dark-mode-toggle>

I header-kontekst

Slik ser den ut i en header

Artsdatabanken

Bruk

Slik fungerer det

  1. Når komponenten kobles til siden, leser den localStorage-nøkkelen adb-theme.
  2. Finnes ingen lagret verdi, brukes prefers-color-scheme fra operativsystemet.
  3. Komponenten setter data-theme="light" eller data-theme="dark" på <html>. Design tokens fra @artsdatabanken/tokens reagerer på dette attributtet.
  4. Ved klikk byttes temaet, valget lagres i localStorage, og hendelsen adb-theme-change sendes.

Merk: Komponenten tar over data-theme på <html> så snart den vises på siden. Har applikasjonen allerede egen temahåndtering, må den synkroniseres med adb-theme i localStorage eller lytte på adb-theme-change.

Lytte på temaendringer

document.addEventListener('adb-theme-change', (e) => {
console.log('Nytt tema:', e.detail.theme); // 'light' | 'dark'
});

Komponenten setter temaet først når JavaScript har lastet. For å unngå at siden blinker i feil tema, kan du sette data-theme med et lite inline-skript i <head>:

<script>
(function () {
var t = localStorage.getItem('adb-theme');
if (!t) t = matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
document.documentElement.setAttribute('data-theme', t);
})();
</script>

API

Komponenten har ingen attributter. Tilgjengelig navn settes automatisk: «Mørkt tema» i lyst tema og «Lyst tema» i mørkt tema. Tekstene er like på bokmål og nynorsk, og kan foreløpig ikke overstyres.

Hendelser

HendelseDetailBeskrivelse
adb-theme-change{ theme: 'light' | 'dark' }Sendes ved klikk. theme er det nye temaet. Bobler og krysser shadow DOM.

CSS Parts

PartBeskrivelse
buttonDet indre <button>-elementet
adb-dark-mode-toggle::part(button) {
/* overstyr det indre <button>-elementet */
}

Lagring

NøkkelVerdierBeskrivelse
localStorage['adb-theme']'light' | 'dark'Brukerens valgte tema

Universell utforming (WCAG 2.1 AA)

KriteriumNivåOppfyltMerknad
1.1.1 Ikke-tekstlig innholdA✅Ikonet har tilgjengelig navn via aria-label
1.4.11 Kontrast for ikke-tekstlig innholdAA✅Ikonet bruker accent-farge
2.1.1 TastaturA✅Native <button> — Enter og Space fungerer
2.4.7 Fokus synligAA✅4 px fokusring ved :focus-visible
2.5.5 Størrelse på målAAA✅48 × 48 px
4.1.2 Navn, rolle, verdiA⚠️Knappen bruker både aria-pressed og et navn som skifter med tilstanden. I mørkt tema leses den som «Lyst tema, trykket», noe som kan misforstås.