@artsdatabanken/components
v2.2.1
Published
Artsdatabanken Web Component design system
Keywords
Readme
@artsdatabanken/components
Web Components for the Artsdatabanken design system — built with Lit, works in Angular, React 19+, Drupal, and any framework that supports custom elements.
Installasjon
npm install @artsdatabanken/components @artsdatabanken/tokensBruk
Importer tokens globalt i CSS:
@import '@artsdatabanken/tokens';Registrer komponenter i JavaScript:
import '@artsdatabanken/components';Eller importer kun det du trenger:
import '@artsdatabanken/components/button';Bruk i HTML:
<adb-button variant="primary" color="accent">Lagre</adb-button>Komponenter
<adb-button>
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| variant | 'primary' \| 'secondary' \| 'tertiary' | 'primary' | Visuell vekt |
| color | 'accent' \| 'danger' | 'accent' | Fargetema (ignoreres for tertiary) |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| disabled | boolean | false | Deaktiver knappen |
| href | string | — | Når satt, rendres <a> i stedet for <button> |
| target | '_self' \| '_blank' \| '_parent' \| '_top' | — | Lenke-mål (kun med href) |
| download | string | — | Filnavn for nedlasting (kun med href) |
| rel | string | — | Lenkerelasjoner (auto noopener noreferrer ved _blank) |
| aria-controls | string | — | ID-en til elementet knappen styrer |
| aria-expanded | 'true' \| 'false' | — | Om det kontrollerte elementet er åpent |
Slots:
| Slot | Beskrivelse |
|---|---|
| (default) | Knappetekst |
| icon-start | Ikon før teksten |
| icon-end | Ikon etter teksten |
CSS Parts:
base— det indre<button>-elementet, for tilpasning via::part(base)
Eksempler:
<!-- Primærknapp -->
<adb-button>Send inn</adb-button>
<!-- Sekundær fareknapp -->
<adb-button variant="secondary" color="danger">Slett</adb-button>
<!-- Lenkeknapp — rendrer <a> internt -->
<adb-button href="/artskart" variant="secondary">Gå til Artskart</adb-button><adb-icon-button>
Sirkulær ikon-only knapp. aria-label er påkrevd.
import '@artsdatabanken/components/icon-button';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| variant | 'primary' \| 'secondary' \| 'tertiary' | 'primary' | Visuell vekt |
| color | 'accent' \| 'danger' | 'accent' | Fargetema |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| disabled | boolean | false | Deaktiver knappen |
| aria-label | string | — | Påkrevd — beskriver handlingen |
Støtter også type, href, target, rel, aria-controls og aria-expanded som <adb-button>.
<adb-icon-button aria-label="Lukk dialog">
<adb-icon name="close"></adb-icon>
</adb-icon-button><adb-minimal-button>
Transparent ikonknapp for verktøylinjer og mindre fremtredende handlinger.
import '@artsdatabanken/components/minimal-button';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| variant | 'default' \| 'attention' | 'default' | Default (accent) eller Attention (fare) |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| disabled | boolean | false | Deaktiver knappen |
| aria-label | string | — | Påkrevd — beskriver handlingen |
Støtter også type, href, target, rel, aria-controls og aria-expanded som <adb-button>.
<adb-minimal-button aria-label="Søk">
<adb-icon name="search"></adb-icon>
</adb-minimal-button><adb-accordion> / <adb-accordion-item>
Trekkspill bygget på native <details>/<summary>.
import '@artsdatabanken/components/accordion';
import '@artsdatabanken/components/accordion-item';<adb-accordion> (wrapper):
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| variant | 'neutral' \| 'subtle' | 'neutral' | Visuell stil |
<adb-accordion-item> (element):
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| heading | string | — | Overskriftstekst |
| help-text | string | — | Sekundærtekst etter overskriften |
| open | boolean | false | Om elementet er utvidet |
Slots: heading, help-text, badge, (default).
CSS-variabler (<adb-accordion-item>):
| Variabel | Standard | Beskrivelse |
|---|---|---|
| --adb-accordion-summary-padding | var(--adb-spacing-sm) | Luft rundt summary-raden |
| --adb-accordion-content-padding-inline-start | var(--adb-spacing-md) | Innrykk på startsiden av innholdet |
| --adb-accordion-content-padding-inline-end | var(--adb-accordion-summary-padding) | Innrykk på sluttsiden av innholdet. Følger summary-luften slik at badges og innhold deler samme høyrekant |
| --adb-accordion-content-padding-block-end | var(--adb-spacing-lg) | Luft under innholdet |
Nøstede trekkspill arver 0 som innrykk på sluttsiden, siden forelderens innholdsboks
allerede står for luften. Uten dette ville innrykket lagt seg oppå hverandre for hvert
nivå, og badges ville forskjøvet seg mot venstre nedover i hierarkiet. Luften under
innholdet (--adb-accordion-content-padding-block-end) arver også 0 for nøstede
elementer, slik at den ikke bygger seg opp under hvert utvidet nivå.
<adb-accordion>
<adb-accordion-item heading="Overskrift" help-text="hjelpetekst">
<span slot="badge">42</span>
<p>Innhold som vises når elementet er åpent.</p>
</adb-accordion-item>
</adb-accordion><adb-alert>
Varsel-komponent for tilbakemeldinger — feil, advarsler, info, suksess og nøytrale meldinger.
import '@artsdatabanken/components/alert';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| variant | 'danger' \| 'warning' \| 'info' \| 'success' \| 'neutral' | 'info' | Semantisk variant |
| type | 'default' \| 'inline' | 'default' | Boks (default) eller inline |
| size | 'sm' \| 'md' | 'md' | Størrelse (kun inline) |
| heading | string | '' | Overskrift |
| global | boolean | false | Kant-til-kant (ingen border-radius) |
| closable | boolean | false | Vis lukkeknapp |
| auto-close | boolean | false | Skjul ved lukking |
Slots: heading, meta (Space Mono 12px), default (brødtekst)
Events: adb-close — utløses ved klikk på lukkeknappen
<adb-alert variant="warning" closable heading="Planlagt vedlikehold">
<span slot="meta">31. januar 2025 kl. 08:00</span>
<p>Tjenesten vil være utilgjengelig i perioden 08:00–10:00.</p>
</adb-alert>
<!-- Inline -->
<adb-alert variant="success" type="inline" heading="Sitering kopiert"></adb-alert><adb-card>
Generisk kort-komponent som dekker alle korttyper fra Figma (Editorial, Handbook, Species, Nature, Contact) via komposisjon av slots — ingen egne komponenter per korttype. Hele kortet blir klikkbart når href er satt (CSS "stretched link", ingen JavaScript påkrevd).
import '@artsdatabanken/components/card';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| overline | string | — | Liten etikett over tittelen |
| heading | string | — | Korttittel |
| heading-level | number (2–6) | 3 | Overskriftsnivå (<h2>–<h6>) |
| subtitle | string | — | Sekundærtekst under tittelen |
| href | string | — | URL kortet lenker til — gjør hele kortet klikkbart |
| orientation | 'vertical' \| 'horizontal' \| 'auto' | 'vertical' | Plassering av media relativt til tekst. auto gjør kortet container-responsivt |
| auto-breakpoint | number (px) | 480 | Kortbredden der orientation="auto" bytter fra vertikal til horisontal |
| media-fit | 'cover' \| 'contain' \| 'none' | 'cover' | Hvordan innholdet i media-sloten fyller mediecontaineren |
| media-background | 'subtle' \| 'none' | 'subtle' | Sett none for å fjerne bakgrunnsplaten bak transparente ikoner/illustrasjoner |
| overline-case | 'capitalize' \| 'none' \| 'uppercase' \| 'lowercase' | 'capitalize' | Bokstavsetting på overline. Bruk none for å beholde setningscase |
| media-max-width | string (CSS-lengde) | — | Setter maksbredde på mediecontaineren i horisontal orientering (f.eks. 132px), begrenset til maks 50 % av kortet. Uten verdi bestemmer bildet bredden (fortsatt maks 50 %) |
| size | 'lg' \| 'md' \| 'sm' | 'lg' | Skalerer padding, skrift og medieutsnitt |
Slots: overline-icon, overline, heading, subtitle, media, media-badge, footer.
CSS Parts: card, overline, title, subtitle, footer, media.
CSS-variabler: --adb-card-media-padding — innvendig luft i mediecontaineren (standard 0, eller --adb-spacing-md når media-fit="none").
Komponenten setter selv attributtet resolved-orientation (vertical | horizontal) på verten. Det er skrivebeskyttet, men kan brukes til å style mot den orienteringen som faktisk gjelder når orientation="auto" er i bruk.
<adb-card overline="Rovdyr" heading="Gaupe" subtitle="Lynx lynx" href="/arter/gaupe">
<img slot="media" src="/bilder/gaupe.jpg" alt="" />
<p slot="footer">Brødtekst med eget innhold …</p>
</adb-card>
<!-- Horisontal (kontaktkort/ansattkort) -->
<adb-card orientation="horizontal" media-max-width="132px" heading="Ane Myhre" subtitle="Seniorrådgiver" href="/ansatte/ane-myhre">
<img slot="media" src="/bilder/ane.jpg" alt="" />
</adb-card>
<!-- Container-responsivt: vertikalt i smal kontekst, horisontalt i bred -->
<adb-card orientation="auto" heading="Gaupe" subtitle="Lynx lynx" href="/arter/gaupe">
<img slot="media" src="/bilder/gaupe.jpg" alt="" />
</adb-card>
<!-- Ikon i stedet for foto: naturlig størrelse, ingen bakgrunnsplate -->
<adb-card media-fit="none" media-background="none" overline-case="none"
overline="Artsprosjektet" heading="Om prosjektet" href="/artsprosjektet">
<svg slot="media" width="48" height="48" aria-hidden="true"><!-- … --></svg>
</adb-card>orientation="auto" måler kortets egen bredde med en ResizeObserver og bytter mellom vertikal og horisontal ved auto-breakpoint (480 px som standard). Da kan samme kortmarkup brukes både i hovedspalten og i en smal sidekolonne uten å hardkode orientering per bruksområde. Uten ResizeObserver (f.eks. ved SSR) faller auto tilbake til vertikal.
Standard media-fit="cover" beskjærer foto til å fylle mediecontaineren. Bruk contain for illustrasjoner som skal vises i sin helhet, og none for ikoner som skal beholde sin naturlige størrelse og sentreres — da settes ikke lenger et fast bildeformat på mediecontaineren. Kombiner gjerne med media-background="none" for transparente ikoner.
I horisontal orientering bestemmer bildets egen størrelse mediebredden som standard, men mediet tar aldri mer enn 50 % av kortbredden. Sett media-max-width (CSS-lengde) for en lavere maksbredde til ensartede kort — bildet tilpasser seg opp til denne grensen, og beskjæres via object-fit: cover når det er bredere. Verdien begrenses uansett til 50 %. artsdatabanken.no bruker 132px.
<adb-checkbox>
Avkrysningsboks med etikett, valgfri hjelpetekst og teller. Støtter avkrysset, delvis valgt (indeterminate) og deaktivert tilstand.
import '@artsdatabanken/components/checkbox';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| checked | boolean | false | Om boksen er avkrysset |
| indeterminate | boolean | false | Delvis valgt (for «velg alle»-mønstre) |
| disabled | boolean | false | Deaktiver boksen |
| value | string | 'on' | Verdi når boksen er avkrysset |
| name | string | '' | Navn |
| description | string | '' | Hjelpetekst under etiketten (alternativ til description-sloten) |
| aria-label | string | — | Tilgjengelig navn når det ikke finnes synlig etikett |
Slots: (default) (etikett), description, counter (teller til høyre)
CSS-deler: control, label, description
Hendelser: change, input
<adb-checkbox name="rodliste" value="ja">Vis kun rødlistede arter</adb-checkbox>
<adb-checkbox checked description="Funn registrert siste 12 måneder">
Nylige funn
<span slot="counter">42</span>
</adb-checkbox>Merk: Den native
<input>ligger i shadow DOM, så verdien sendes ikke med ved vanlig<form>-innsending. Leschecked/valueeller lytt påchange. For Angular-skjemaer (ngModel, reactive forms), brukAdbCheckboxValueAccessorfra@artsdatabanken/angular.
<adb-switch>
Bryter for å slå en innstilling av og på med umiddelbar effekt. Støtter tre størrelser, hjelpetekst, deaktivert tilstand og valgfrie ikoner i sporet (f.eks. sol/måne).
import '@artsdatabanken/components/switch';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| checked | boolean | false | Om bryteren er på |
| disabled | boolean | false | Deaktiver bryteren |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| value | string | 'on' | Verdi når bryteren er på |
| name | string | '' | Navn |
| description | string | '' | Hjelpetekst under etiketten (alternativ til description-sloten) |
| aria-label | string | — | Tilgjengelig navn — påkrevd når det ikke finnes synlig etikett (f.eks. kun ikoner) |
Slots: (default) (etikett), description, icon-unchecked (ikon i av-posisjon), icon-checked (ikon i på-posisjon)
CSS-deler: track, thumb, label, description
Hendelser: change, input
<adb-switch checked>Arter og underarter</adb-switch>
<adb-switch description="Flater ut hele strukturen.">Arter og underarter</adb-switch>
<!-- Med ikoner: sporet er alltid aksentfarget, tommelen ligger bak aktivt ikon -->
<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>Merk: Som for
<adb-checkbox>ligger den native<input>i shadow DOM, så verdien sendes ikke med ved vanlig<form>-innsending. Lescheckedeller lytt påchange. For Angular-skjemaer, brukAdbSwitchValueAccessorfra@artsdatabanken/angular.
<adb-radio> / <adb-radio-group>
Radioknapper for ett valg blant flere. Bruk <adb-radio> inne i <adb-radio-group>, som gir fieldset/legend-semantikk og sørger for at kun én er valgt.
import '@artsdatabanken/components/radio';
import '@artsdatabanken/components/radio-group';<adb-radio-group>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| label | string | '' | Gruppens ledetekst (vises som <legend>) |
| value | string | '' | Verdien til valgt radioknapp |
| name | string | '' | Felles navn som settes på alle radioknappene |
| orientation | 'vertical' \| 'horizontal' | 'vertical' | Retning |
| disabled | boolean | false | Deaktiver hele gruppen |
CSS-deler: label (<legend>)
CSS-variabler: --adb-radio-group-gap — avstand mellom radioknappene (standard var(--adb-spacing-sm))
Hendelser: change — når valgt verdi endres
<adb-radio>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| checked | boolean | false | Om radioknappen er valgt |
| disabled | boolean | false | Deaktiver radioknappen |
| value | string | '' | Verdi |
| name | string | '' | Navn (settes av gruppen) |
| description | string | '' | Hjelpetekst under etiketten (alternativ til description-sloten) |
| aria-label | string | — | Tilgjengelig navn når det ikke finnes synlig etikett |
Slots: (default) (etikett), description, counter
CSS-deler: control, label, description
Hendelser: change, input
<adb-radio-group label="Visning" name="visning" value="kart">
<adb-radio value="kart">Kart</adb-radio>
<adb-radio value="liste" description="Tabell med alle funn">Liste</adb-radio>
</adb-radio-group>Samme forbehold om skjemainnsending og Angular som for <adb-checkbox>.
<adb-search>
Søkefelt med valgfri søk-knapp.
import '@artsdatabanken/components/search';<!-- Med knapp (standard) -->
<adb-search placeholder="Søk i arter" button-variant="filled"></adb-search>
<!-- Uten knapp (frittstående) -->
<adb-search variant="standalone" placeholder="Søk"></adb-search>| Egenskap | Type | Standard | Beskrivelse |
|---|---|---|---|
| size | 'xsm' \| 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| variant | 'with-button' \| 'standalone' | 'with-button' | Layout-variant |
| button-variant | 'filled' \| 'outlined' | 'outlined' | Knappens visuelle stil |
| placeholder | string | 'Søk i [type innhold]' | Plassholdertekst |
| value | string | '' | Gjeldende verdi |
| disabled | boolean | false | Deaktiverer feltet |
| label | string | 'Søk' | aria-label for tilgjengelighet |
| button-text | string | 'Søk' | Tekst i knappen |
Hendelser: adb-search, adb-input, adb-clear
CSS-variabel: --adb-search-width — overstyr bredden på inndatafeltet.
<adb-tabs> / <adb-tab> / <adb-tab-panel>
Fanenavigasjon. Med <adb-tab-panel>-barn viser komponenten selv riktig panel. Uten paneler håndterer du innholdet selv via tab-change, f.eks. med en router. Piltastene, Home og End flytter mellom fanene.
import '@artsdatabanken/components/tabs'; // registrerer også <adb-tab> og <adb-tab-panel><adb-tabs>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| variant | 'neutral' \| 'nostalgic' | 'neutral' | Understrek (neutral) eller boks (nostalgic) |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| selected-index | number | 0 | Indeks for valgt fane (0-basert) |
| aria-label | string | — | Tilgjengelig navn for <nav>-landemerket |
Slots: tab (<adb-tab>-elementer), (default) (<adb-tab-panel>-elementer), actions (f.eks. sorteringsknapp etter fanene)
Hendelser: tab-change — detail: { index: number }
<adb-tab>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| selected | boolean | false | Om fanen er valgt (styres av <adb-tabs>) |
| disabled | boolean | false | Deaktiver fanen |
| href | string | — | Rendrer fanen som <a> i stedet for <button> |
| target | '_self' \| '_blank' \| '_parent' \| '_top' | — | Lenke-mål (kun med href) |
| aria-current | string | — | Markerer gjeldende side, f.eks. "page" |
Slots: (default) (fanetekst), icon
<adb-tab-panel>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| active | boolean | false | Om panelet vises (styres av <adb-tabs>) |
CSS-deler: base på både <adb-tab> og <adb-tab-panel>
<!-- Med paneler -->
<adb-tabs aria-label="Visning">
<adb-tab slot="tab">Kart</adb-tab>
<adb-tab slot="tab">Liste</adb-tab>
<adb-tab-panel>Kartinnhold …</adb-tab-panel>
<adb-tab-panel>Listeinnhold …</adb-tab-panel>
</adb-tabs>
<!-- Som lenker -->
<adb-tabs aria-label="Hovednavigasjon">
<adb-tab slot="tab" href="/natursystem" aria-current="page" selected>Natursystem</adb-tab>
<adb-tab slot="tab" href="/naturkompleks">Naturkompleks</adb-tab>
</adb-tabs><adb-dropdown>
Knapp som åpner en meny med valg. Håndterer åpning og lukking, klikk utenfor, Escape og piltaster.
import '@artsdatabanken/components/dropdown'; // registrerer også meny, gruppe og element<adb-dropdown>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| label | string | '' | Tekst i knappen |
| icon | string | '' | Ikonnavn foran teksten (bruker <adb-icon>) |
| variant | 'primary' \| 'secondary' \| 'tertiary' | 'tertiary' | Visuell vekt på knappen |
| size | 'sm' \| 'md' \| 'lg' | 'sm' | Størrelse |
| open | boolean | false | Om menyen er åpen |
| disabled | boolean | false | Deaktiver knappen |
Hendelser:
| Hendelse | Detail | Beskrivelse |
|---|---|---|
| adb-dropdown-select | { value: string } | Et valg ble gjort |
| adb-dropdown-open | — | Menyen åpnet |
| adb-dropdown-close | — | Menyen lukket |
CSS-deler: trigger, menu
Underelementer:
| Element | Attributter | Beskrivelse |
|---|---|---|
| <adb-dropdown-group> | label | Grupperer valg under en overskrift |
| <adb-dropdown-item> | value, selected, disabled | Ett valg i menyen |
| <adb-dropdown-menu> | open | Selve menypanelet. Kan brukes alene med egen trigger. CSS-del menu, CSS-variabel --adb-dropdown-menu-min-width (standard 10rem) |
<adb-dropdown icon="sort" label="Artsnavn stigende">
<adb-dropdown-group label="Navn">
<adb-dropdown-item value="name-asc" selected>Artsnavn stigende</adb-dropdown-item>
<adb-dropdown-item value="name-desc">Artsnavn synkende</adb-dropdown-item>
</adb-dropdown-group>
</adb-dropdown><adb-pagination>
Sidenavigasjon med valgfri velger for antall per side og «gå til side»-felt. Sett total-pages når antall sider er kjent, eller bruk has-more-pages når det ikke er det (f.eks. cursor-basert paginering). Antall sideknapper tilpasser seg tilgjengelig bredde.
import '@artsdatabanken/components/pagination';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| current-page | number | 1 | Aktiv side (1-basert). Oppdateres internt og reflekteres til attributtet |
| total-pages | number | — | Totalt antall sider. Utelat for ubestemt modus |
| total-items | number | — | Totalt antall elementer. Brukes i intervall-teksten (f.eks. «1–10 av 216») |
| has-more-pages | boolean | false | Om det finnes flere sider (ubestemt modus) |
| visible-pages | number | 5 | Maks antall sideknapper (inkl. første/siste) |
| min-visible-pages | number | 3 | Minste antall sideknapper på smale skjermer |
| page-size | number | 0 | Elementer per side. 0 skjuler velgeren |
| page-size-options | string | '' | Kommaseparerte valg, f.eks. "10,25,50" |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| nav-label | string | 'Sidenavigasjon' | Tilgjengelig navn for <nav>-landemerket |
| show-jump-to | boolean | false | Vis «gå til side»-felt |
Hendelser:
| Hendelse | Detail | Beskrivelse |
|---|---|---|
| page-change | { page: number } | Brukeren navigerte til en ny side |
| page-size-change | { pageSize: number } | Brukeren endret antall per side (sender også page-change til side 1) |
CSS-deler: nav, page-size
<adb-pagination
total-pages="22"
total-items="216"
page-size="10"
page-size-options="10,25,50"
></adb-pagination><adb-toc> / <adb-toc-item>
Sammenleggbar innholdsfortegnelse med overskriften «Innhold». Hvilket element som er aktivt styres av deg via active.
import '@artsdatabanken/components/toc'; // registrerer også <adb-toc-item><adb-toc>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| default-open | boolean | false | Om listen starter utvidet |
| open | boolean | false | Om listen er utvidet (reflekteres til attributtet) |
| variant | 'default' \| 'narrow' | 'default' | Full bredde eller kompakt |
Hendelser: toggle — når listen åpnes eller lukkes
CSS-deler: toggle, list
<adb-toc-item>:
| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| href | string | '' | Lenkemål, typisk et anker på siden |
| active | boolean | false | Markerer seksjonen som vises nå |
CSS-deler: link
<adb-toc default-open>
<adb-toc-item href="#utbredelse" active>Utbredelse</adb-toc-item>
<adb-toc-item href="#levevis">Levevis</adb-toc-item>
<adb-toc-item href="#forvaltning">Forvaltning</adb-toc-item>
</adb-toc><adb-menu-toggle>
Meny-/lukk-knapp for mobilmenyen. Viser «Meny» med hamburgerikon når menyen er lukket og «Lukk» med kryss når den er åpen. Knappen bytter open selv ved klikk og sender adb-menu-toggle. Visning av selve menyen må du håndtere.
import '@artsdatabanken/components/menu-toggle';| Attributt | Type | Standard | Beskrivelse |
|---|---|---|---|
| open | boolean | false | Om menyen er åpen (reflekteres til attributtet) |
| label-open | string | 'Meny' | Knappetekst når menyen er lukket |
| label-close | string | 'Lukk' | Knappetekst når menyen er åpen |
| controls | string | — | ID-en til menyen (settes som aria-controls) |
Hendelser: adb-menu-toggle — detail: { open: boolean } (den nye tilstanden)
CSS-deler: button
<adb-menu-toggle controls="hovedmeny"></adb-menu-toggle>
<nav id="hovedmeny" hidden>…</nav><adb-logo>
Artsdatabankens logo — logosymbol + navnetrekk. Støtter norsk (Bokmål/Nynorsk) og engelsk, tre størrelser, og lenke-atferd.
import '@artsdatabanken/components/logo';<!-- Standard (norsk, medium) -->
<adb-logo></adb-logo>
<!-- Som lenke -->
<adb-logo href="https://artsdatabanken.no"></adb-logo>
<!-- Engelsk, stor -->
<adb-logo language="en" size="lg"></adb-logo>| Egenskap | Type | Standard | Beskrivelse |
|------------|-------------------------|----------|-----------------------------------------------------------|
| href | string | — | Gjør logoen til en lenke |
| language | 'nb' \| 'nn' \| 'en' | 'nb' | Språkvariant |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
| tooltip | string | Auto | Tooltip-tekst (brukes kun når href er satt) |
CSS-deler: symbol, logotype, link
<adb-avatar>
Logo kun som symbol — brukes til profilbilder på sosiale medier og kompakte flater.
import '@artsdatabanken/components/avatar';<adb-avatar background="rounded"></adb-avatar>
<adb-avatar background="circle" size="lg"></adb-avatar>| Egenskap | Type | Standard | Beskrivelse |
|--------------|------------------------------------------------|----------|---------------|
| background | 'none' \| 'square' \| 'rounded' \| 'circle' | 'none' | Bakgrunnsform |
| size | 'sm' \| 'md' \| 'lg' | 'md' | Størrelse |
CSS-deler: symbol, background
<adb-dark-mode-toggle>
Bytter mellom lyst og mørkt tema ved å sette data-theme på <html>. Valget lagres i localStorage (adb-theme); uten lagret valg brukes prefers-color-scheme.
import '@artsdatabanken/components/dark-mode-toggle';<adb-dark-mode-toggle></adb-dark-mode-toggle>Ingen attributter. Tilgjengelig navn («Mørkt tema» / «Lyst tema») settes automatisk.
Hendelser: adb-theme-change — detail: { theme: 'light' | 'dark' }
CSS-deler: button
CDN
For bruk uten npm — Lit er inkludert i bundelen:
<link rel="stylesheet" href="https://cdn.example.com/@artsdatabanken/[email protected]/tokens.css" />
<script type="module" src="https://cdn.example.com/@artsdatabanken/[email protected]/cdn/adb-components.js"></script>Verktøy
markExternalLinks(container, options)
Automatisk merking av eksterne lenker. Brukes med lenkestilene fra @artsdatabanken/tokens/link.
import { markExternalLinks } from '@artsdatabanken/components/utils';
markExternalLinks(document, {
whitelistedHosts: ['artsdatabanken.no', 'lister.artsdatabanken.no'],
});| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
| container | HTMLElement \| Document | document | Elementet som skannes |
| options.whitelistedHosts | string[] | [] | Vertsnavn som regnes som interne |
| options.srText | string | '(ekstern lenke)' | Skjermlesertekst |
| options.srOnlyClass | string | 'adb-sr-only' | CSS-klasse for skjult tekst |
Framework-integrasjon
- Angular: Fungerer direkte — legg til
CUSTOM_ELEMENTS_SCHEMAi modulen - React 19+: Fungerer direkte — custom elements støttes nativt
- Drupal + Vite: Importer i JavaScript entry-filen; bruk
:not(:defined)CSS for å unngå FOUC
Se dokumentasjonen for detaljerte integrasjonsguider.
