@artsdatabanken/tokens
v1.1.4
Published
Design tokens for Artsdatabanken design system
Keywords
Readme
@artsdatabanken/tokens
Design tokens for the Artsdatabanken design system — colours, spacing, typography, and dark mode as CSS custom properties.
Installasjon
npm install @artsdatabanken/tokensBruk
Importer alle tokens (primitives, semantic, spacing, og dark mode):
@import '@artsdatabanken/tokens';Eller importer kun det du trenger:
@import '@artsdatabanken/tokens/primitives';
@import '@artsdatabanken/tokens/semantic';
@import '@artsdatabanken/tokens/spacing';
@import '@artsdatabanken/tokens/dark';Lenkestiler (opt-in)
Importer separat — disse styles ikke med hovedimporten:
@import '@artsdatabanken/tokens/link';Eksempel
.card {
background: var(--adb-surface-default);
color: var(--adb-text-primary);
padding: var(--adb-spacing-md);
border: 1px solid var(--adb-border-default);
border-radius: var(--adb-radius-md);
}Dark mode
Aktiveres automatisk med prefers-color-scheme: dark, eller manuelt med data-theme="dark" på et overordnet element:
<body data-theme="dark">
<!-- Alle tokens bytter til mørk modus -->
</body>Tving lyst tema med data-theme="light".
Navnekonvensjon
| Type | Mønster | Eksempel |
|---|---|---|
| Primitiver | --adb-{gruppe}-{palett}-{skala} | --adb-brand-freshwater-blue-90 |
| Semantiske | --adb-{rolle} | --adb-surface-accent, --adb-text-primary |
| Spacing | --adb-spacing-{navn} | --adb-spacing-sm, --adb-spacing-md |
| Radius | --adb-radius-{navn} | --adb-radius-3xl |
| Font | --adb-font-family-{rolle} | --adb-font-family-primary |
CDN
For bruk uten npm (f.eks. prototyping):
<link rel="stylesheet" href="https://cdn.example.com/@artsdatabanken/[email protected]/tokens.css" />Lenkestiler
Opt-in CSS-klasser for <a>-elementer. Importeres separat:
@import '@artsdatabanken/tokens/link';Klasser
| Klasse | Brukes på | Beskrivelse |
|---|---|---|
| .adb-link | <a> | Styler en enkelt lenke |
| .adb-link-area | Container | Styler alle <a> inne i containeren |
| .adb-link--external | <a> | Legger til eksternt-lenke-ikon |
Eksempler
<!-- Enkelt lenke -->
<a href="/about" class="adb-link">Om oss</a>
<!-- Alle lenker i en container -->
<div class="adb-link-area">
<p>Se <a href="/rodlista">Rødlista</a> og <a href="/artskart">Artskart</a>.</p>
</div>
<!-- Ekstern lenke -->
<a href="https://gbif.org" class="adb-link adb-link--external"
target="_blank" rel="noopener noreferrer">GBIF</a>Typografiverktøy
Opt-in CSS-klasser for typografi. Inkluderes automatisk med hovedimporten (@import '@artsdatabanken/tokens'), eller separat:
@import '@artsdatabanken/tokens/typography';Overskrifter
| Klasse | Font-størrelse (token) | Kommentar |
|---|---|---|
| .adb-heading-2xsm | --adb-font-size-4 | Minste overskrift |
| .adb-heading-xsm | --adb-font-size-4 | |
| .adb-heading-sm | --adb-font-size-6 | |
| .adb-heading-md | --adb-font-size-7 | |
| .adb-heading-lg | --adb-font-size-8 | |
| .adb-heading-xl | --adb-font-size-10 | |
| .adb-heading-2xl | --adb-font-size-12 | Største overskrift |
Alle overskriftsklasser bruker font-weight: 700, line-height: 1.2 (1.155 for 2xl), og ingen bunn-margin som standard.
Legg til .adb-heading--margin for responsiv bunn-margin:
2xsm–md:margin-bottom: var(--adb-spacing-xsm)lg–2xl:margin-bottom: var(--adb-spacing-sm)
<h1 class="adb-heading-2xl adb-heading--margin">Norsk artskunnskap</h1>
<h2 class="adb-heading-lg">Rødlista 2021</h2>
<h3 class="adb-heading-md adb-heading--margin">Pattedyr</h3>