Bryter (Switch)
<adb-switch> lar brukeren slå noe av eller på. Endringen skal ha umiddelbar effekt — for eksempel å vise eller skjule innhold, eller slå et varsel av og på.
Bruk bryter når valget trer i kraft med en gang. Bruk avkrysningsboks når valget er en del av et skjema som sendes inn, eller når brukeren skal velge flere ting fra en liste.
Deaktivert
Dersom bryteren er deaktivert skal musepekeren endres til å være et stoppsymbol for å indikere at valget ikke kan gjøres.
Eksempel
Tilstander
Av og på
Deaktivert
Størrelser
Bruk size-attributtet: sm, md (standard) eller lg.
Med hjelpetekst
Bruk description-attributtet eller description-sloten for å forklare hva bryteren gjør.
<adb-switch checked description="Flater ut hele strukturen."> Arter og underarter</adb-switch>Med ikoner
Legg ikoner i icon-unchecked- og icon-checked-slotene for å vise hva de to posisjonene betyr — for eksempel sol og måne for lyst og mørkt tema. Med ikoner er sporet alltid aksentfarget, og tommelen ligger bak det aktive ikonet. Hakemerket vises ikke.
Ikonene er dekorative og skjules for skjermlesere. Når bryteren ikke har synlig etikett, må du gi den et tilgjengelig navn med aria-label.
<adb-switch aria-label="Mørkt tema"> <adb-icon slot="icon-unchecked" name="light-mode"></adb-icon> <adb-icon slot="icon-checked" name="dark-mode"></adb-icon></adb-switch>API
Egenskaper (Properties)
| Egenskap | Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|---|
checked | checked | boolean | false | Om bryteren er på |
disabled | disabled | boolean | false | Deaktiverer interaksjon |
size | size | 'sm' | 'md' | 'lg' | 'md' | Størrelse |
value | value | string | 'on' | Verdi når bryteren er på |
name | name | string | '' | Skjemanavn |
description | description | string | '' | Hjelpetekst under etiketten |
ariaLabel | aria-label | string | — | Tilgjengelig navn — påkrevd uten synlig etikett |
Slots
| Slot | Beskrivelse |
|---|---|
| (default) | Etikettekst |
description | Hjelpetekst (alternativ til attributtet) |
icon-unchecked | Ikon i av-posisjon (venstre) |
icon-checked | Ikon i på-posisjon (høyre) |
CSS Parts
| Part | Beskrivelse |
|---|---|
track | Sporet |
thumb | Tommelen som glir frem og tilbake |
label | Etikettekst-wrapperen |
description | Beskrivelsestekst-wrapperen |
Hendelser (Events)
| Hendelse | Beskrivelse |
|---|---|
change | Utløses når bryteren slås av eller på |
input | Utløses ved brukerinteraksjon |
Universell utforming (WCAG 2.1 AA)
| Kriterium | Nivå | Status | Merknad |
|---|---|---|---|
| 1.3.1 Informasjon og relasjoner | A | ✅ | Nativ <input type="checkbox" role="switch"> i en <label> |
| 1.4.3 Kontrast (minimum) | AA | ✅ | Etikett og hjelpetekst bruker teksttokens med tilstrekkelig kontrast |
| 1.4.11 Kontrast for ikke-tekstlig innhold | AA | ✅ | Kantlinjen på sporet har 7,6:1 mot bakgrunnen (5,4:1 i mørk modus). Tilstanden vises med tommelposisjon, sporfarge og hakemerke. |
| 2.1.1 Tastatur | A | ✅ | Fokuseres med Tab, slås av/på med mellomromstasten |
| 2.4.7 Fokus synlig | AA | ✅ | 4 px fokusring rundt sporet (focus-visible) |
| 2.3.3 Animasjon fra interaksjoner | AAA | ✅ | Animasjonen skrus av med prefers-reduced-motion |
| 4.1.2 Navn, rolle, verdi | A | ✅ | Skjermlesere leser «bryter, på/av». Bruk aria-label når det ikke finnes synlig etikett |
Merk: Den hvite tommelen mot det grå av-sporet i lys modus har rundt 3:1 kontrast. Tilstanden formidles i tillegg av tommelposisjon og hakemerket i på-tilstand.
Angular
Bruk AdbSwitchValueAccessor fra @artsdatabanken/angular for ngModel og reactive forms:
import '@artsdatabanken/components/switch';import { AdbSwitchValueAccessor } from '@artsdatabanken/angular';<adb-switch adbSwitch [(ngModel)]="visUnderarter">Arter og underarter</adb-switch>FOUC-håndtering (Drupal / SSR)
For å unngå visuelt hopp mens komponenten lastes, reserver plass med :not(:defined):
adb-switch:not(:defined) { display: block; visibility: hidden; min-height: 1.5rem; /* høyden til md-sporet */}Installasjon
npm install @artsdatabanken/components// Full bundleimport '@artsdatabanken/components';
// Kun switch (tree shaking)import '@artsdatabanken/components/switch';<adb-switch>Nyhetsbrev</adb-switch><adb-switch checked description="Flater ut hele strukturen.">Arter og underarter</adb-switch>