Header
Release dato: 25.08.2023
Sist oppdatert: -
Headeren er den globale navigasjonen for tjenester og nettsider i Oslo kommune. Den gir tydelig avsender og gjenkjennelighet på tvers av løsninger, og skal være lik på alle sider i en applikasjon.
I headeren kan brukeren få tilgang til meny, innlogget meny og logg ut-funksjon. Ved å klikke på brukernavnet åpnes en ekspandert meny.
Denne komponenten er under forbedring. Har du innspill, forslag eller tilbakemeldinger? Ta kontakt på #punkt på Slack eller send en e-post til punkt@origo.oslo.kommune.no.
Live demo
Relaterte komponenter
Innhold nederst på siden eller løsningen din.
Samler navigasjonslenker i en meny i toppen
Viser hvor brukeren befinner seg i sidens struktur
Varianter
Type | Bruk |
---|---|
Innlogget header | Brukes i de fleste innloggede løsninger, viser logo, tjenestenavn, innlogget meny og/eller logg ut-knapp |
Utlogget header | Brukes på åpne sider som oslo.kommune.no, viser logo, søkefelt, megameny og kontaktlenker |
Merk: Denne dokumentasjonen beskriver kun innlogget header. Utlogget header utvikles som del av oslo.kommune.no og webforvaltningen og kommer snart i Punkt.
Retningslinjer for bruk
Bruk header når
- løsningen har Oslo kommune som avsender
- du vil gi brukeren tilgang til navigasjon eller innlogget funksjonalitet
- du vil tydeliggjøre at løsningen tilhører Oslo kommune
Dersom løsningen er et internt verktøy eller en side uten offentlig tilgang, kan en egen header være mer hensiktsmessig. Dette må vurderes grundig og som hovedregel bør du alltid bruke header-komponenten.
Headeren skal være enkel å bruke
Oslo-logoen skal alltid vises til venstre, i sin helhet. Tjenestenavn er valgfritt, men anbefales for tydelighet. Bruk kun nødvendige navigasjonselementer, og sørg for at strukturen er lik på alle sider i tjenesten.
Gjør slik
Unngå
Innhold i header
Logo og avsender skal alltid stå til venstre. Navigasjonselementer som meny, innlogget meny og logg ut-knapp plasseres til høyre. Ikke bruk alle elementer samtidig, velg det som passer brukerens behov.
Behold struktur og utseende
Du kan tilpasse bakgrunnsfargen i headeren, men må sørge for god kontrast og at det fortsatt matcher Oslo kommunes visuelle profil.
Oslo-logoen skal ikke kombineres med andre logoer og må alltid vises i sin helhet. Les mer om riktig bruk av Oslo-logoen
Gjør slik
Unngå
Søk i header
Søkefelt er ikke inkludert i innlogget header for å unngå forvirring med søket på oslo.kommune.no, som er globalt. Hvis du trenger søk i en innlogget løsning, bør det plasseres som en egen komponent, for eksempel rett under header eller i hovedinnholdet.
Responsivitet
Headeren tilpasser seg automatisk til skjermstørrelsen. På mobil samles navigasjonen i menyen. Du kan velge om brukeren skal vises med initialer eller ikon.
Test alltid headeren på mobil, nettbrett og desktop.
Universell utforming
Headeren skal være tilgjengelig for alle – uansett hvilke hjelpemidler eller navigasjonsmetoder brukeren benytter. Det betyr at den må fungere med både tastatur, skjermleser og andre assistive teknologier.
Gjør headeren forståelig og navigerbar
- Alle interaktive elementer skal kunne brukes med tastatur alene (for eksempel med “Tab”, “Enter” og “Esc”).
- Bruk beskrivende og tydelige tekster på knapper og lenker, unngå generiske lenketekster som “Klikk her”.
- Sørg for tilstrekkelig kontrast mellom tekst og bakgrunn.
Bruk landemerker og ARIA-roller riktig:
<header>
ellerrole="banner"
for headerrole="navigation"
ogaria-label
på meny hvis det finnes flere navigasjoner på sidenaria-expanded
ogaria-controls
for å indikere tilstand på nedtrekksmenyer
Tilpasset ulike brukere og kontekster
Forskning fra GOV.UK viser at brukere forventer:
- Konsistent plassering av navigasjon på tvers av sider
- Enkle og intuitive etiketter på menyvalg
- At det er lett å skille mellom innhold og navigasjon
- Mulighet for å forstå hvor man er i løsningen (for eksempel via aktiv tilstand eller breadcrumbs)
Viktig om implementasjon
Hvis du bruker React- eller Elements-versjonen av header, er riktig ARIA-støtte innebygd. Bruker du bare CSS, må du selv sørge for:
- ARIA-attributter for meny og nedtrekk
- Fokus-støtte og tastaturnavigasjon
- At
aria-expanded
oppdateres riktig når menyen åpnes og lukkes
Forskning og anbefalinger for hvordan brukere forstår og beveger seg i digitale tjenester
Hvordan navigasjon og meny skal fungere med tastatur og skjermleser
Anatomi
Element | Beskrivelse |
---|---|
1. Bakgrunn | Hvit bakgrunn i hele headeren |
2. Oslo-logo | Plassert til venstre, lenker til forsiden |
3. Tjenestenavn (valgfritt) | Navn på tjeneste ved siden av logoen |
4. Meny (valgfritt) | Meny for navigasjon |
5. Innlogget meny (valgfritt) | Meny for innloggede brukere |
6. Logg ut-knapp (valgfritt) | Knapp for utlogging |
Implementasjon i kode
Hvordan ta komponenten i bruk?
import { PktHeader } from '@oslokommune/punkt-react';
Props og tokens
Prop | Type | Beskrivelse |
---|---|---|
logoLink | string | Hva skjer når brukeren klikker på logoen? |
serviceName | string | Navnet på tjenesten som vises i headeren |
fixed | boolean | Skal headeren være fast i toppen av siden? |
scrollToHide | boolean | Skal headeren skjules når brukeren skroller ned? |
user | object | Brukerobjektet som inneholder informasjon om den innloggede brukeren |
userMenu | array | Menyen som vises når brukeren klikker på brukerknapp |
userMenuFooter | array | Innholdet som vises i bunnen av brukermenyen |
userOptions | array | Alternativer for brukeren som kan endres |
representing | object | Objekt som inneholder informasjon om representasjon, hvis aktuelt |
canChangeRepresentation | boolean | Skal brukeren kunne endre representasjon? |
showLogOutButton | boolean | Skal logg ut-knappen vises i headeren? |
showMenuButton | boolean | Skal menyknappen vises i headeren? |
Event | Beskrivelse |
---|---|
changeRepresentation | Bruker endrer representasjon |
logIn | Bruker klikker på logg inn-knappen |
logOut | Bruker klikker på logg ut-knappen |
Farger
Element | CSS Variabel |
---|---|
Background | |
Text and links | |
Merk: Tekst, lenker og ikoner styres av hvilken du velger (f.eks. primær-, sekundær-, tertiær-button eller forskjellige farger). Se oversikt over alle varianter av button og link.