Komponenten
Seitenzahlen (Pagination)
StabilLange 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
Stepperrichtig, 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
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
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
Paginationrendert einnav-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-hiddenausgeblendet. - Alle Knöpfe sind native
button-Elemente:Tabfokussiert,EnterundLeertastelösen aus.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| onPageChange | (page: number) => void | – | Ja | Called with the new page number (1-based). |
| page | number | – | Ja | Active page, counted from 1. |
| pageCount | number | – | Ja | Total number of pages. |
| siblingCount | number | 1 | Nein | Page numbers shown on each side of the active page. |