Gå til innholdet

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

Arter og underarter

Tilstander

Av og på

NyhetsbrevArter og underarter

Deaktivert

Arter og underarterArter og underarter

Størrelser

Bruk size-attributtet: sm, md (standard) eller lg.

Liten (sm)Medium (md)Stor (lg)

Med hjelpetekst

Bruk description-attributtet eller description-sloten for å forklare hva bryteren gjør.

Arter og underarter
<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)

EgenskapAttributtTypeStandardBeskrivelse
checkedcheckedbooleanfalseOm bryteren er på
disableddisabledbooleanfalseDeaktiverer interaksjon
sizesize'sm' | 'md' | 'lg''md'Størrelse
valuevaluestring'on'Verdi når bryteren er på
namenamestring''Skjemanavn
descriptiondescriptionstring''Hjelpetekst under etiketten
ariaLabelaria-labelstring—Tilgjengelig navn — påkrevd uten synlig etikett

Slots

SlotBeskrivelse
(default)Etikettekst
descriptionHjelpetekst (alternativ til attributtet)
icon-uncheckedIkon i av-posisjon (venstre)
icon-checkedIkon i på-posisjon (høyre)

CSS Parts

PartBeskrivelse
trackSporet
thumbTommelen som glir frem og tilbake
labelEtikettekst-wrapperen
descriptionBeskrivelsestekst-wrapperen

Hendelser (Events)

HendelseBeskrivelse
changeUtløses når bryteren slås av eller på
inputUtløses ved brukerinteraksjon

Universell utforming (WCAG 2.1 AA)

KriteriumNivåStatusMerknad
1.3.1 Informasjon og relasjonerA✅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 innholdAA✅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 TastaturA✅Fokuseres med Tab, slås av/på med mellomromstasten
2.4.7 Fokus synligAA✅4 px fokusring rundt sporet (focus-visible)
2.3.3 Animasjon fra interaksjonerAAA✅Animasjonen skrus av med prefers-reduced-motion
4.1.2 Navn, rolle, verdiA✅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

Terminal window
npm install @artsdatabanken/components
// Full bundle
import '@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>