Tag

Release dato: 12.06.2023

Sist oppdatert: 31.10.2024

En tag (også kalt badge eller chip) brukes for å merke, kategorisere eller organisere innhold med korte nøkkelord. Den kan hjelpe brukeren å raskt skanne informasjon, skille mellom kategorier eller filtrere innhold.

Live demo

Relaterte komponenter

Varianter

Varianter

VariantBruk
Kun tekstStandard variant
Med ikonNår ikonet skal understøtte eller forsterke teksten
Med “lukk”-ikonNår tag brukes til filtrering og brukeren skal kunne fjerne valget

Størrelser

Tag finnes i flere størrelser og farger, og kan brukes med eller uten ikon. Når en tag brukes til filtrering, kan den ha et “lukk”-ikon slik at brukeren kan fjerne valget.

StørrelseBruk
SmallNår tagen brukes tett på annet innhold og trenger å være diskret
Medium (default)Standardstørrelse som passer i de fleste tilfeller
LargeNår teksten er lengre eller tagen skal være mer fremtredende

Retningslinjer for bruk

Bruk tag når

  • du skal merke eller gruppere informasjon etter nøkkelord
  • du vil la brukeren filtrere på kategorier
  • du trenger en kort og lettlest markør i grensesnittet

Unngå tag når

  • informasjonen krever lengre forklaringer
  • farge alene er brukt for å formidle mening
  • du ønsker et interaktivt element som tar brukeren til en ny side eller løsning (bruk heller button)

Skriv korte og konsise tags

Sørg for at teksten i tagen er klar og konsis, det er viktig å bruke korte tekster for enkel skanning. Bruk to ord kun om det er nødvendig for å beskrive statusen eller skille den fra en annen tag. Dersom den skal bli lest av skjermleser må den også inkludere kontekst.

Gjør slik

Gjør slik – Skriv tydelige og korte tekster som gir mening i kontekst
Skriv tydelige og korte tekster som gir mening i kontekst

Unngå

Unngå – for korte og uklare tekster uten kontekst
Unngå for korte og uklare tekster uten kontekst

Ikke bruk kun farge for å skille tags fra hverandre

Farge bør ikke brukes som det eneste middelet for å skille tags fra hverandre. Sørg for at informasjonen som tillegges fargen også kommer tydelig frem i innholdet, via tekst og ikon. Dersom du bruker egendefinerte farger, må kravene til minimum kontrast overholdes.

Gjør slik

Gjør slik – Bruk tekst og farge sammen for å tydeliggjøre status
Bruk tekst og farge sammen for å tydeliggjøre status

Unngå

Unngå – å bruke kun farge for å skille tags fra hverandre
Unngå å bruke kun farge for å skille tags fra hverandre

Bruk av ikon i tags

Dersom du bruker ikon skal dette alltid vises på venstre side av teksten. Ikonet skal underbygge teksten i tagen. Ikke bruk tag med kun ikon, dette gjør det vanskelig for brukeren å skjønne betydningen.

Gjør slik

Gjør slik – Bruk ikon sammen med tekst for å underbygge innholdet
Bruk ikon sammen med tekst for å underbygge innholdet

Unngå

Unngå – tag med kun ikon eller ulogisk ikon
Unngå tag med kun ikon eller tag med ulogisk ikon

Responsivitet

Tag skalerer godt på alle skjermstørrelser og bryter linjer der det er nødvendig.

På små skjermer bør du vurdere om mange tags kan gjøre grensesnittet uoversiktlig eller dytter ned viktig innhold. Trunker eller avkort lange tekster for å unngå at de bygger for mange linjer.

Universell utforming

Teksten må gi mening i kontekst

En tag bør alltid ha en kort og tydelig tekst som gir mening når den leses opp av skjermlesere. Ikke bruk generiske ord som “Ny” alene, men skriv for eksempel “Ny søknad” slik at sammenhengen blir forståelig.

Bruk aria-label for lukkbare tags

For lukkbare tags kan du sende inn en valgfri ariaLabel som gir skjermlesere mer informasjon. Denne vil da leses opp i stedet for selve teksten i tagen. Uten ariaLabel vil skjermleseren lese opp tekstinnholdet i tagen, etterfulgt av en standardbeskrivelse: “Klikk for å fjerne [tagtekst]”.

Ikke bruk farge alene

Fargen på en tag blir ikke opplest av skjermlesere og er ikke nok som meningsbærer for brukere med svakt eller dårlig syn. Sørg derfor for at informasjonen fargen skal formidle også kommer tydelig frem i tekst eller ikon. Du kan også legge til skjult hjelpetekst som kun blir lest opp av skjermlesere.

Tags som knapper

Når en tag kan lukkes eller klikkes, får den rollen som en knapp og skal kunne fokuseres og aktiveres med tastatur. Sørg for at dette fungerer konsekvent.

Anatomi

ElementBeskrivelse
Ikon (valgfritt)Understøtter teksten
TekstKort og tydelig innhold som beskriver status eller kategori
BakgrunnBakgrunnsfarge for tag
“Lukk”-ikonBrukes til filtrering slik at brukeren kan fjerne valget

Implementasjon i kode

Hvordan ta komponenten i bruk?

Testing

Elements og React: Dersom du skal skrive tester med JSDOM eller liknende er det viktig at du lar komponenten bli rendret ferdig før du tester den. Dette kan gjøres ved å kjøre denne kodelinjen før testene kjøres:

await window.customElements.whenDefined("pkt-tag");

Dersom du bruker verktøyene i punkt-testing-utils så kan dette bli gjort automatisk for deg.

Props og tokens

PropTypeBeskrivelse
sizesmall
medium
large
Størrelsen på taggen
iconNameiconNavnet på ikonet som skal vises i taggen
skinblue
blue-light
blue-dark
green
red
beige
yellow
gray
Utseendet til taggen
closeTagbooleanSkal taggen ha en lukkeknapp?
textStylethin-text
normal-text
Stilen på teksten i taggen
typebutton
submit
reset
Type tag, brukes for å spesifisere om det er en knapp, submit eller reset
ariaLabelstringaria-label for taggen, brukes for tilgjengelighet
Slot (children)Beskrivelse
defaultTeksten til tag

Farger

ElementCSS variabel
Background
Text