Zum Inhalt springen
Dokumentation

Komponenten

Seitenzahlen (Pagination)

Stabil

Lange Listen in Seiten aufteilen – mit Zurück, Weiter und direkter Seitennummer.

Seitenzahlen teilen eine lange Liste in handliche Abschnitte: die Betten eines Hauses, die offenen Tickets einer Station, das Archiv eines Monats. Du siehst immer nur einen Ausschnitt und weißt trotzdem, wie viele Seiten es gibt.

Wann verwenden

  • Wenn eine Liste zu lang zum Scrollen ist und die Einträge eine feste Reihenfolge haben.
  • Wenn du die Position in der Liste sehen willst: „Seite 6 von 12“ sagt mehr als ein bloßer Weiter-Knopf.
  • Wenn du direkt zu einer Seite springen möchtest, etwa um ans Ende eines Archivs zu kommen.

Wann nicht

  • Bei kurzen Listen bis etwa sieben Einträgen ist Blättern unnötig; zeige alle.
  • Wenn du ständig weiterklickst, um zusammengehörige Einträge zu sehen, ist die Aufteilung zu klein. Nimm größere Seiten oder Filter.
  • Für einen schrittweisen Ablauf ist Stepper richtig, nicht die Seitennavigation. Diese zählt Daten, keinen Fortschritt.

Aufbau

Pagination ist eine gesteuerte Komponente: Du hältst die aktuelle Seite in deinem Zustand und bekommst über onPageChange die gewünschte Seite. Die Komponente rendert Zurück, die Seitenzahlen samt Auslassungszeichen und Weiter. page zählt ab 1, pageCount ist die Gesamtzahl der Seiten.

Seite 1 von 12

Beispiel und Quelltext
belegung.tsx
import * as React from "react";

import { Pagination } from "@neodin-eu/ui";

const SEITEN = 12;

function Belegung() {
  const [seite, setSeite] = React.useState(1);

  return (
    <div className="flex w-full max-w-md flex-col items-center gap-3">
      <p className="text-sm text-muted-foreground">
        Seite {seite} von {SEITEN}
      </p>
      <Pagination
        page={seite}
        pageCount={SEITEN}
        onPageChange={setSeite}
        aria-label="Seitennavigation der Bettenbelegung"
      />
    </div>
  );
}

Kurze Bereiche

Bis siblingCount * 2 + 5 Seiten zeigt die Komponente alle Zahlen ohne Auslassungszeichen. Bei der Standardeinstellung siblingCount={1} sind das sieben Seiten. Erst ab acht Seiten ersetzt ein Auslassungszeichen die Lücke zwischen erster Seite, Umgebung und letzter Seite.

Tickets · Seite 3 von 5

Beispiel und Quelltext
tickets.tsx
import * as React from "react";

import { Pagination } from "@neodin-eu/ui";

const SEITEN = 5;

function Tickets() {
  const [seite, setSeite] = React.useState(3);

  return (
    <div className="flex w-full max-w-md flex-col items-center gap-3">
      <p className="text-sm text-muted-foreground">
        Tickets · Seite {seite} von {SEITEN}
      </p>
      <Pagination
        page={seite}
        pageCount={SEITEN}
        onPageChange={setSeite}
        aria-label="Seitennavigation der Ticketliste"
      />
    </div>
  );
}

Barrierefreiheit

  • Pagination rendert ein nav-Element mit dem zugänglichen Namen „Seitennavigation“ aus dem Sprachkatalog. Das ist im Komponententest abgesichert.
  • Jeder Zahlenknopf hat einen Namen wie „Seite 4“; die aktuelle Seite trägt zusätzlich aria-current="page". Der Komponententest prüft beides.
  • „Zurück“ ist auf der ersten Seite gesperrt, „Weiter“ auf der letzten. Ein gesperrter Knopf ist nicht fokussierbar und löst keine Aktion aus; auch das ist im Komponententest abgesichert.
  • Die Auslassungszeichen sind mit aria-hidden ausgeblendet.
  • Alle Knöpfe sind native button-Elemente: Tab fokussiert, Enter und Leertaste lösen aus.

Props

Props von Pagination
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
onPageChange(page: number) => void–JaCalled with the new page number (1-based).
pagenumber–JaActive page, counted from 1.
pageCountnumber–JaTotal number of pages.
siblingCountnumber1NeinPage numbers shown on each side of the active page.

Siehe auch