Pagination

Sist oppdatert: 19.11.2026

Pagination (paginering) deler lange lister, tabeller og søkeresultater opp i sider. Brukeren kan bla til forrige eller neste side, eller hoppe rett til en bestemt side.

Har du noen innspill til komponenten?Gi oss beskjed!

Test komponenten

Kodebygger

PktPagination

Innhold
Hvor mange sider det finnes. Med 0 sider rendres ingenting.
Siden brukeren er på, fra 1. Pagineringen flytter den selv ved klikk, og følger verdien når den endres utenfra.
Utseende
Hvor mange sider som vises på hver side av gjeldende side når den ligger midt i listen. Nær første og siste side fylles plassene med flere sider i stedet, så pagineringen har like mange elementer hele veien. 1 gir 7 elementer, 2 gir 9. Når pagineringen er smalere enn 400 px, vises ingen sider ved siden av gjeldende side.
Hva pagineringen viser når den er smalere enn 400 px. ends viser første, siste og gjeldende side, for eksempel 1 … 10 … 20. range viser fem sider rundt gjeldende side, for eksempel 8 9 10 11 12.
Hvor sidene står i bredden pagineringen har.
Funksjonalitet
Gjør sidene til lenker. {page} byttes ut med sidetallet, for eksempel ?side={page}. Uten mal blir sidene knapper.
Teknisk
<PktPagination
totalPages={20}
currentPage={5}
hrefTemplate="?side={page}" />

Relaterte komponenter

Varianter

VariantBruk
StandardSiden brukeren er på vises som en fylt sirkel. Passer de fleste steder.
Med kantlinjeSiden brukeren er på vises som en ring. Gir et roligere og mer åpent uttrykk.
Uten tekst«Forrige» og «Neste» vises bare som piler. Nyttig når det er lite plass.
Pagination i tre varianter: standard, med kantlinje og uten tekst.

Retningslinjer for bruk

Bruk pagination når

  • en liste, tabell eller et søkeresultat er for lang til å vises på én side
  • brukeren trenger å vite hvor i listen de er, og hvor mye som er igjen
  • brukeren skal kunne gå tilbake til en bestemt side eller dele lenken til den

Unngå pagination når

  • alt innholdet får plass på én side
  • brukeren blar gjennom innhold uten å lete etter noe bestemt (bruk heller «Vis flere»)
  • brukeren skal gjennom steg i en bestemt rekkefølge (bruk heller forrige- og neste-lenker)

Plasser pagineringen rett under innholdet

Pagineringen hører til listen den styrer. Plasser den rett under listen, slik at brukeren finner den når de har lest seg ferdig.

Gjør slik

Plasser pagineringen rett under listen den hører til

Unngå

Unngå å skille pagineringen fra listen med annet innhold

Som standard står pagineringen til venstre. Du kan også midtstille den eller legge den til høyre med align. Velg det som passer med innholdet over, og bruk samme plassering i hele løsningen.

Vis hvor mange treff det er

Fortell brukeren hvor mange treff det er, og hvilke som vises nå, for eksempel «Viser treff 18 til 25 av 131». Da er det lettere å vite hvor langt man har kommet.

Gjør slik

Vis antall treff over listen

Unngå

Unngå at brukeren må gjette hvor mye innhold det er

Velg mellom lenker og knapper

Bruk lenker når hver side har sin egen adresse, for eksempel i søkeresultater. Da kan brukeren dele lenken til en side og bruke tilbakeknappen i nettleseren. Bruk knapper når innholdet byttes ut uten at adressen endres, for eksempel i en tabell som henter neste side selv.

Antall sider som vises

Når det er god plass viser pagineringen første og siste side, siden brukeren er på, og en side på hver side av den, for eksempel 1 … 9 10 11 … 20. Trenger du flere, kan du øke antallet med siblingCount. På små flater vises færre sider, se Responsivitet.

Pagineringen har like mange knapper på alle paginerte sider. Dette gjør at størrelse og plassering er fast og at knappene ikke flytter på seg under musepekeren når brukeren blar.

Responsivitet

Pagineringen tilpasser seg plassen den får, ikke bredden på skjermen.

  • Under 576px vises «Forrige» og «Neste» bare som piler
  • Under 400px vises bare første, siste og gjeldende side, for eksempel 1 … 10 … 20
  • Under 300px blir knappene mindre, så pagineringen får plass også på de minste skjermene
Pagination på en smal flate, vist med første og siste side og med sidene rundt gjeldende side.

På små flater kan du velge å vise sidene rundt gjeldende side i stedet, for eksempel 4 5 6 7 8. Det passer når brukeren blar side for side, som i et arkiv. Behold standarden når brukeren ofte vil tilbake til første side, eller trenger å se hvor mange sider det er.

Pagination på en smal flate, vist med første og siste side og med sidene rundt gjeldende side.

Universell utforming

  • Pagineringen er et eget navigasjonselement med aria-label «Paginering». Har du flere pagineringer på samme side, gi dem ulike navn med attributten aria-label
  • Skjermlesere leser «Gå til side 5» på sidetallene, og «Side 5» på siden brukeren er på
  • «Forrige» og «Neste» leses opp også når bare pilene vises
  • På første og siste side er «Forrige» og «Neste» deaktivert, men de blir stående. Da hopper ikke sidetallene, og fokus forsvinner ikke
  • Fokus blir på siden brukeren valgte, også når sidetallene rundt endrer seg
  • Bruker du knappenavigering, flytt fokus til starten av innholdet når brukeren bytter side. Da får også skjermleserbrukere med seg at innholdet er byttet ut

Anatomi

ElementBeskrivelse
1. ForrigeGår til forrige side. Er deaktivert på første side.
2. SideGår til siden med dette nummeret
3. Gjeldende sideSiden brukeren er på
4. Utelatelsestegn (ellipse)Tre prikker som viser at det finnes sider som ikke vises
5. NesteGår til neste side. Er deaktivert på siste side.
Elementene i anatomien til pagination.

Implementasjon i kode

Pagination er tilgjengelig som både React-komponent og web component (Elements).

Lenker eller knapper

Med hrefTemplate (href-template i Elements) blir sidene lenker. {page} byttes ut med sidetallet. Uten hrefTemplate blir sidene knapper.

<pkt-pagination total-pages="20" current-page="1" href-template="?side={page}"></pkt-pagination>
<PktPagination totalPages={20} currentPage={side} hrefTemplate="?side={page}" />

Pagineringen flytter gjeldende side selv når brukeren velger en ny. Endrer du currentPage utenfra, følger den etter.

Reagere på sidebytte

onPageChange i React og page-change-eventet i Elements sier fra når brukeren velger en side.

<pkt-pagination total-pages="20"></pkt-pagination>
<script>
  document.querySelector('pkt-pagination').addEventListener('page-change', (event) => {
    visSide(event.detail.page)
  })
</script>
const [side, setSide] = useState(1)

<PktPagination totalPages={20} currentPage={side} onPageChange={(page) => setSide(page)} />

Bruke din egen ruter

Bruker du lenker sammen med en ruter, kan ruteren bytte side i stedet for nettleseren. I React rendrer du lenkene med din egen lenkekomponent, for eksempel Next.js Link, med renderLink. Send props videre, ellers mister lenken aria-current og klikkhåndteringen. I Elements kaller du preventDefault() i page-change og bytter side med ruteren din.

<pkt-pagination total-pages="20" href-template="?side={page}"></pkt-pagination>
<script>
  document.querySelector('pkt-pagination').addEventListener('page-change', (event) => {
    event.preventDefault()
    minRouter.push(`?side=${event.detail.page}`)
  })
</script>
<PktPagination
  totalPages={20}
  currentPage={side}
  hrefTemplate="/sok?side={page}"
  renderLink={({ href, className, children, props }) => (
    <Link href={href} className={className} {...props}>
      {children}
    </Link>
  )}
/>

Bredde

Pagineringen fyller bredden den står i. Står den i en flex-rad eller et annet element som krymper til innholdet, tar den opptil 640 px. Er den bredere, for eksempel med mange sider rundt gjeldende side, kan du gi den en bredde eller sette --pkt-pagination-preferred-width.

.min-paginering {
  --pkt-pagination-preferred-width: 48rem;
}

Hvordan ta komponenten i bruk?

import @oslokommune/punkt-elements/dist/pkt-pagination.js;
import { PktPagination } from '@oslokommune/punkt-react';
<script src="https://punkt-cdn.oslo.kommune.no/20/elements/pkt-pagination.js" type="module"></script>

Testing

Elements: 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-pagination");

Egenskaper

PktPagination

Props

Prop:
totalPages
total-pages
Type:
number
Beskrivelse:
Hvor mange sider det finnes. Med 0 sider rendres ingenting.
Prop:
currentPage?
current-page?
Type:
number
Standardverdi:
1
Beskrivelse:
Siden brukeren er på, fra 1. Pagineringen flytter den selv ved klikk, og følger verdien når den endres utenfra.
Prop:
siblingCount?
sibling-count?
Type:
number
Standardverdi:
1
Beskrivelse:
Hvor mange sider som vises på hver side av gjeldende side når den ligger midt i listen. Nær første og siste side fylles plassene med flere sider i stedet, så pagineringen har like mange elementer hele veien. 1 gir 7 elementer, 2 gir 9. Når pagineringen er smalere enn 400 px, vises ingen sider ved siden av gjeldende side.
Prop:
hrefTemplate?
href-template?
Type:
string
Beskrivelse:
Gjør sidene til lenker. {page} byttes ut med sidetallet, for eksempel ?side={page}. Uten mal blir sidene knapper.
Prop:
hideText?
hide-text?
Type:
boolean
Standardverdi:
false
Beskrivelse:
Viser bare pilene i «Forrige» og «Neste». Teksten er der fortsatt for skjermlesere. Når pagineringen er smalere enn 576 px, skjules teksten uansett.
Prop:
outlined?
Type:
boolean
Standardverdi:
false
Beskrivelse:
Viser gjeldende side som en ring i stedet for en fylt sirkel.
Prop:
smallView?
small-view?
Type:
"ends" | "range"
Standardverdi:
"ends"
Beskrivelse:
Hva pagineringen viser når den er smalere enn 400 px. ends viser første, siste og gjeldende side, for eksempel 1 … 10 … 20. range viser fem sider rundt gjeldende side, for eksempel 8 9 10 11 12.
Prop:
align?
Type:
"start" | "center" | "end"
Standardverdi:
"start"
Beskrivelse:
Hvor sidene står i bredden pagineringen har.
Prop:
renderLink?
Type:
(args: IRenderLink) => ReactNode
Beskrivelse:
React: Funksjon for å rendre en egendefinert lenkekomponent (f.eks. Next.js Link eller React Router Link). Mottar et IRenderLink-objekt med href, className, children og props. Standard er et vanlig <a>-element.

Events

Event:
onPageChange
Type:
(page: number, event: MouseEvent) => void
Beskrivelse:
Kalles med sidetallet når brukeren velger en annen side. Med lenker stopper event.preventDefault() navigeringen.
Event:
page-change
Type:
CustomEvent<{ page: number; originalEvent: MouseEvent }>
Beskrivelse:
Fyres når brukeren velger en annen side. Sidetallet ligger i event.detail.page. Med lenker stopper preventDefault() navigeringen.

Objektet som sendes til renderLink i Link, BackLink og Breadcrumbs. Kun React — brukes til å bytte ut standard <a> med f.eks. Next.js Link eller React Router Link.

Prop:
href
Type:
string
Beskrivelse:
Mål-URL for lenken.
Prop:
className
Type:
string
Beskrivelse:
CSS-klasser Punkt har satt på lenken.
Prop:
children
Type:
ReactNode
Beskrivelse:
Innhold/label som skal rendres inni lenken.
Prop:
props
Type:
AnchorHTMLAttributes<HTMLAnchorElement>
Beskrivelse:
Resten av anchor-attributter (f.eks. onClick, aria-*) som skal spreades på lenken.