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.

Live demo

Relaterte komponenter

Varianter

TypeBruk
Innlogget headerBrukes i de fleste innloggede løsninger, viser logo, tjenestenavn, innlogget meny og/eller logg ut-knapp
Utlogget headerBrukes 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.

Innlogget header
Utlogget header

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

Eksempel på anbefalt bruk av header
Bruk tydelig Oslo-logo og eventuelt tjenestenavn til venstre

Unngå

Eksempel på ikke anbefalt bruk av header
Unngå å ende plassering eller størrelse på logo eller meny

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

Eksempel på anbefalt bruk av Oslo kommunes visuelle profil
Forhold deg til Oslo kommunes visuelle profil og prioriter standard og gjenkjennelig headerstyling slik at brukeren lett kan navigere mellom åpne og innloggede sider

Unngå

Eksempel på ikke anbfelat bruk av Oslo kommunes visuelle identitet
Unngå å bryte Oslo kommunes visuelle identitet og overlesse headeren med mange elementer

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> eller role="banner" for header
  • role="navigation" og aria-label på meny hvis det finnes flere navigasjoner på siden
  • aria-expanded og aria-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

Anatomi

ElementBeskrivelse
1. BakgrunnHvit bakgrunn i hele headeren
2. Oslo-logoPlassert 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?

Props og tokens

PropTypeBeskrivelse
logoLinkstringHva skjer når brukeren klikker på logoen?
serviceNamestringNavnet på tjenesten som vises i headeren
fixedbooleanSkal headeren være fast i toppen av siden?
scrollToHidebooleanSkal headeren skjules når brukeren skroller ned?
userobjectBrukerobjektet som inneholder informasjon om den innloggede brukeren
userMenuarrayMenyen som vises når brukeren klikker på brukerknapp
userMenuFooterarrayInnholdet som vises i bunnen av brukermenyen
userOptionsarrayAlternativer for brukeren som kan endres
representingobjectObjekt som inneholder informasjon om representasjon, hvis aktuelt
canChangeRepresentationbooleanSkal brukeren kunne endre representasjon?
showLogOutButtonbooleanSkal logg ut-knappen vises i headeren?
showMenuButtonbooleanSkal menyknappen vises i headeren?
EventBeskrivelse
changeRepresentationBruker endrer representasjon
logInBruker klikker på logg inn-knappen
logOutBruker klikker på logg ut-knappen

Farger

ElementCSS 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.