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
Bruk
Slik fungerer det
- Når komponenten kobles til siden, leser den
localStorage-nøkkelenadb-theme. - Finnes ingen lagret verdi, brukes
prefers-color-schemefra operativsystemet. - Komponenten setter
data-theme="light"ellerdata-theme="dark"på<html>. Design tokens fra@artsdatabanken/tokensreagerer på dette attributtet. - Ved klikk byttes temaet, valget lagres i
localStorage, og hendelsenadb-theme-changesendes.
Merk: Komponenten tar over
data-themepå<html>så snart den vises på siden. Har applikasjonen allerede egen temahåndtering, må den synkroniseres medadb-themeilocalStorageeller lytte påadb-theme-change.
Lytte på temaendringer
document.addEventListener('adb-theme-change', (e) => { console.log('Nytt tema:', e.detail.theme); // 'light' | 'dark'});Unngå blink ved sidelasting
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
| Hendelse | Detail | Beskrivelse |
|---|---|---|
adb-theme-change | { theme: 'light' | 'dark' } | Sendes ved klikk. theme er det nye temaet. Bobler og krysser shadow DOM. |
CSS Parts
| Part | Beskrivelse |
|---|---|
button | Det indre <button>-elementet |
adb-dark-mode-toggle::part(button) { /* overstyr det indre <button>-elementet */}Lagring
| Nøkkel | Verdier | Beskrivelse |
|---|---|---|
localStorage['adb-theme'] | 'light' | 'dark' | Brukerens valgte tema |
Universell utforming (WCAG 2.1 AA)
| Kriterium | Nivå | Oppfylt | Merknad |
|---|---|---|---|
| 1.1.1 Ikke-tekstlig innhold | A | ✅ | Ikonet har tilgjengelig navn via aria-label |
| 1.4.11 Kontrast for ikke-tekstlig innhold | AA | ✅ | Ikonet bruker accent-farge |
| 2.1.1 Tastatur | A | ✅ | Native <button> — Enter og Space fungerer |
| 2.4.7 Fokus synlig | AA | ✅ | 4 px fokusring ved :focus-visible |
| 2.5.5 Størrelse på mål | AAA | ✅ | 48 × 48 px |
| 4.1.2 Navn, rolle, verdi | A | ⚠️ | 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. |