Zum Hauptinhalt springen

Tabellenpaginierung

Verwendung​

Überblick​

Die Paginierung ermöglicht Benutzern die Navigation durch große Datensätze, da der Inhalt in überschaubare Seiten aufgeteilt wird. Sie bietet Steuerelemente zum Durchsuchen der Seiten und zum Anpassen der Anzahl der gleichzeitig angezeigten Elemente, was für die Leistungsfähigkeit und Lesbarkeit in datenintensiven Anwendungen unerlässlich ist.

Zu verwenden​

  • Zur Verwaltung großer Datensätze: Verwenden Sie diese Option, wenn eine Tabelle Hunderte oder Tausende von Zeilen enthält und das gleichzeitige Rendern aller Zeilen Auswirkungen auf die Leistung oder die Seitenladezeiten hat.
  • Für mehr Überschaubarkeit: Verwenden Sie diese Option, wenn zu viele Daten auf einer Seite die Benutzer überfordern und das Auffinden oder Vergleichen von Werten erschweren.
  • Zur Verbesserung der Barrierefreiheit: Verwenden Sie diese Option, wenn große Tabellen zu Navigationsproblemen für Screenreader oder Tastaturbenutzer führen (z. B. ist eine Tabelle mit Hunderten von Zeilen unübersichtlich).
  • Für gefilterte Ansichten: Zu verwenden, wenn Benutzer in der Regel eine Teilmenge der Daten anzeigen, z. B. Suchergebnisse oder gefilterte Ansichten. Die Paginierung bietet Benutzern Orientierung durch überschaubare Abschnitte.

Nicht zu verwenden​

  • Bei kleinen Datensätzen: Zu vermeiden, wenn sämtliche Zeilen ohne Leistungsprobleme oder Überforderung des Benutzers angezeigt werden können (z. B. 20-50 Zeilen).
  • Für breit angelegte Vergleichsaufgaben: Zu vermeiden, wenn Benutzer viele Zeilen gleichzeitig vergleichen müssen. Ziehen Sie stattdessen virtuelles Scrollen oder gefilterte Ansichten in Betracht.
  • Für Aufgaben mit einer Ansicht: Nicht verwenden, wenn der Datensatz in seiner Gesamtheit dargestellt werden muss und nicht auf mehrere Seiten aufgeteilt werden kann, wie z. B. eine Einstellungstabelle.

Formatierung​

Aufbau​

Aufbau der Paginierungskomponente mit nummerierten Beschriftungen für den Selektor „Zeilen pro Seite“, Anzeige des Elementbereichs und Navigationsschaltflächen.

Die Paginierungskomponente wird im von ihr gesteuerten Inhalt unten angezeigt und besteht aus den folgenden Elementen:

  1. Zeilenauswahl pro Seite: Ein Dropdown-Menü, in dem Benutzer die Anzahl der auf jeder Seite angezeigten Elemente ändern können.
  2. Anzeige des Elementbereichs: Textbeschriftung, die angibt, welche Elemente von der Gesamtzahl der Elemente gerade angezeigt werden (z. B. „1–10 von 25“).
  3. Navigations-Steuerelemente: Symbolschaltflächen, mit denen Benutzer zur vorherigen oder nächsten Datenseite sowie zur ersten und letzten Seite navigieren können.

Inhalt​

Allgemeine Richtlinien fürs Schreiben​

  • Verwenden Sie die Großschreibung des ersten Worts und von Substantiven für alle Aspekte der Gestaltung von Guidewire-Produktschnittstellen. Schreiben Sie nicht alles groß.
  • Verwenden Sie in den meisten Situationen Verben im Präsens und im Aktiv.
  • Verwenden Sie gebräuchliche Abkürzungen, um Ihrem Text einen natürlichen und informellen Ton zu verleihen.
  • Verwenden Sie eine einfache Sprache. Vermeiden Sie unnötigen Jargon und komplexe Sprache.
  • Halten Sie Wörter und Sätze kurz.

Verhalten​

Zustände​

Die primären Zustände der Paginierungskomponente stehen in Beziehung zu ihren Navigations-Steuerelementen.

  • Die Schaltfläche Vorherige Seite muss deaktiviert sein, wenn sich der Benutzer auf der ersten Seite mit Daten befindet.
  • Die Schaltfläche Nächste Seite muss deaktiviert sein, wenn sich der Benutzer auf der letzten Seite mit Daten befindet.

Interaktionen​

  • Durch Auswahl eines neuen Werts aus der Dropdownliste Zeilen pro Seite wird die damit verbundene Komponente neu geladen und die ausgewählte Anzahl von Elementen angezeigt.
  • Durch Klicken auf die Schaltflächen Nächste Seite oder Vorherige Seite navigiert der Benutzer seitenweise durch den Datensatz.

Ansätze zur Verwendung der Paginierung​

  • Standardverwendung: Sie verwenden die Komponente standardmäßig im synchronen Kontext. Kunden stellen die Werte der Komponente direkt zur Verfügung.
  • Verwendung asynchroner Tabellen: Bei Verwendung mit Tabellen, die Daten asynchron von einem Server abrufen, gibt die Paginierung den aktuellen Status der Tabelle wieder. Die Komponente selbst bleibt synchron. Die Tabelle steuert die asynchrone Logik. Dieser Ansatz gilt sowohl für die Standardverwendung als auch für die Verwendung von TanStack Table.
  • Verwendung von TanStack-Tabellen: Wenn Sie eine Tabelle verwenden, die von TanStack Table verwaltet wird, übergibt der Consumer den Paginierungsstatus der Tabelle an die Paginierungskomponente. Dadurch kann die Benutzeroberfläche für die Seitennummerierung den aktuellen Tabellenstatus widerspiegeln, einschließlich aller von der Tabelle verwalteten asynchronen oder servergesteuerten Aktualisierungen.

Barrierefreiheit​

Diese Komponente wurde validiert, um die Richtlinien für Barrierefreiheit WCAG 2.2 AA in der Standardbasiskonfiguration zu erfüllen. Dazu wird u. a. Folgendes sichergestellt:

  • Das Kontrastverhältnis von Textelementen zu ihrem Hintergrund liegt über 4,5:1.
  • Nicht-textuelle Inhalte, die eine Bedeutung vermitteln sollen (z. B. Symbole und Fokusanzeigen), weisen ein Kontrastverhältnis von mindestens 3:1 zu den angrenzenden Farben auf.
  • Das jeweilige Element kann sowohl über eine Tastatur als auch über eine Maus bedient werden.
  • Der Zugriff auf die Inhalte erfolgt über Screenreader wie JAWS oder VoiceOver.

Die Konformität mit den Richtlinien für Barrierefreiheit hängt letztendlich davon ab, wie diese Komponente implementiert und angepasst wird. Vom Autor des Inhalts vorgenommene Änderungen können sich auf die Barrierefreiheit auswirken. Details zu unserem Modell der geteilten Verantwortung finden Sie in unserer Erklärung zur Barrierefreiheit von Jutro.

Beachten Sie bei Verwendung dieser Komponente in Ihrer Anwendung die folgenden Best Practices:

  • Tastatur-Interaktion: Alle Steuerelemente innerhalb der Paginierungskomponente müssen mit der Tastatur fokussierbar und bedienbar sein. Benutzer müssen in der Lage sein, mit der Tab-Taste zwischen der Dropdown-Liste und den Navigationsschaltflächen zu navigieren und sie mit der Enter- oder Space-Taste zu aktivieren.
  • Screenreader: Die Paginierungskomponente muss in ein <nav>-Element mit einem aria-label „Paginierung“ umschlossen werden, um sie als Landmark-Region zu erkennen. Alle Steuerelemente müssen eindeutige, barrierefreie Namen haben. Verwenden Sie für die Navigationsschaltflächen aria-label-Attribute wie „Zur vorherigen Seite wechseln“ und „Zur nächsten Seite wechseln“. Die Anzeige des Elementbereichs (z. B. „1–10 von 25“) muss programmgesteuert mit den Steuerelementen verknüpft sein, damit sie Benutzern von Screenreadern angesagt werden kann, da sie den wesentlichen Kontext für die Navigation bereitstellt.