npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@artsdatabanken/components

v2.2.1

Published

Artsdatabanken Web Component design system

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/tokens

Bruk

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. Les checked/value eller lytt på change. For Angular-skjemaer (ngModel, reactive forms), bruk AdbCheckboxValueAccessor fra @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. Les checked eller lytt på change. For Angular-skjemaer, bruk AdbSwitchValueAccessor fra @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_SCHEMA i 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.

Lisens

Apache 2.0