Beispiele
Im Abschnitt Verwendung finden Sie Informationen zum richtigen Design eines Breadcrumb und den verschiedenen von Guidewire bereitgestellten Konfigurationsoptionen.
Einfaches Beispiel
Fügen Sie eine sekundäre Navigationskomponente hinzu, um dem Benutzer seine aktuelle Position in Bezug auf übergeordnete Ebenen anzuzeigen.
<Breadcrumb
links={[
{
href: 'grandparent-url',
text: 'Grandparent Page',
},
{
href: 'parent-url',
text: 'Parent page',
},
{
text: 'Current Page',
},
]}
/>
Beispiel für letztes Element anklickbar
Standardm äßig ist das letzte Element kein anklickbarer Link. Sie können dies jedoch mit der Eigenschaft lastItemClickable ändern.
<Breadcrumb
lastItemClickable={true}
links={[
{
href: 'grandparent-url',
text: 'Grandparent Page',
},
{
href: 'parent-url',
text: 'Parent page',
},
{
href: 'current-url',
text: 'Current Page',
},
]}
/>
Beispiel für einen Rückverweis (Backlink)
Wenn es nur ein übergeordnetes Element gibt, wird die Komponente als Link mit dem Text „Zurück“ und einem nach links weisenden Pfeil gerendert.
<Breadcrumb
links={[
{
href: 'parent-url',
text: 'Parent page',
},
{
text: 'Current Page',
},
]}
/>
Beispiel für einen Rückverweis ohne Text
Wenn es nur ein übergeordnetes Element gibt und die Eigenschaft backLinkWithoutText true ist, wird die Komponente nur als nach links weisender Pfeil gerendert.
<Breadcrumb
backLinkWithoutText={true}
links={[
{
href: 'parent-url',
text: 'Parent page',
},
{
text: 'Current Page',
},
]}
/>
Verwendung
Überblick
Ein Breadcrumb ist eine sekundäre Navigationskomponente, über die Benutzer ihre aktuelle Position identifizieren und zu einer übergeordneten Ebene oder einem vorherigen Schritt wechseln können. Ein Breadcrumb besteht aus Textlinks. Jeder Link stellt dabei eine Seite dar, die eine Ebene höher liegt und auf die Benutzer schnell zugreifen können.
Breadcrumbs sind ein wichtiges Navigationselement zur Orientierung: Sie zeigen Benutzern ihre aktuelle Position in der hierarchischen Struktur einer Anwendung.
Zu verwenden
- Bei Produkten und Benutzeroberflächen mit Hierarchien, die mehr als zwei Ebenen umfassen.
- Wenn Benutzer wissen sollen, wo in der Informationshierarchie einer Anwendung sie sich befinden.
- Wenn der Benutzer sehr wahrscheinlich über eine externe Quelle auf die Seite gelangt ist.
Nicht zu verwenden
- Als primäre Art der Navigation in einer Anwendung oder auf einer Website.
- Bei Produkten mit Navigation auf einer Ebene.
- Zur Unterstützung der Benutzer beim Nachverfolgen des Fortschritts in einem Prozess mit mehreren Schritten. Verwenden Sie stattdessen eine der Fortschrittsanzeigen.
Aufbau

Die Breadcrumb-Komponente besteht aus den folgenden Elementen:
- Textlink: Breadcrumbs werden als blaue Live-Textlinks angezeigt, wie Hyperlinks. Sie leiten Benutzer zur jeweils übergeordneten Seite.
- Trennzeichen für Textlinks: Das Trennzeichen kennzeichnet die Trennung zwischen den Seiten. Es hat die gleiche Schriftart wie die Textlinks. Trennzeichen sind nicht interaktiv.
- Aktuelles Element: Das Breadcrumb-Element für die Seite, die der Benutzer aktuell anzeigt. Wird als einfacher Text angezeigt.
Position
Positionieren Sie die Breadcrumbs oben links auf der Seite.
Best Practices
- Alle Elemente im Breadcrumb-Pfad (außer der aktuellen Seite) müssen einen Ort darstellen, zu dem der Benutzer wechseln kann. Wenn es eine logische Kategorie gibt, mit der keine Seite verknüpft ist, fügen Sie sie nicht in den Breadcrumb-Pfad ein.
- Breadcrumb-Pfade beginnen normalerweise bei der Startseite. Wenn die globale Navigation jedoch einen Link zur Startseite enthält, sollte der Startseiten-Link nicht in den Breadcrumb-Pfad integriert werden.
- Breadcrumbs sollen die hierarchische Struktur einer Website aufzeigen und nicht den Verlauf der aufgerufenen Seiten.
- Stellen Sie sicher, dass alle Elemente im Breadcrumb-Pfad, mit Ausnahme der aktuellen Seite, aktive Links sind.
- Breadcrumbs dürfen auf Mobilgeräten nicht in mehrere Zeilen umbrochen werden. Sie können den Breadcrumb-Pfad kürzen und nur die erste und die letzte Ebene angeben.
Quelle: Nielsen Norman Group
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.
Seitenlinks
- Die Wörter in Breadcrumb-Textlinks sollten nicht vage, sondern genau, spezifisch und eindeutig sein.
- Benutzer sollten keine Überraschung erleben, wenn sie auf einen Textlink klicken oder tippen.
- In Breadcrumb-Beschriftungen wird idealerweise die übliche Groß- und Kleinschreibung verwendet, wenn dies auch bei den verknüpften Seiten der Fall ist.
Verwenden Sie genaue und spezifische Beschriftungen.
Verwenden Sie keine vagen oder mehrdeutigen Beschriftungen.
Verhalten
- Wenn nur ein Element anzuzeigen ist, werden die Breadcrumbs nicht gerendert. Das bedeutet, dass sich der Benutzer auf der obersten Ebene einer Navigationsstruktur befindet.
- Wenn nur zwei Elemente anzuzeigen sind, wird eine Zurück-Schaltfläche gerendert.
- Wenn mehr als zwei Elemente anzuzeigen sind, wird die normale Breadcrumb-Navigation gerendert.
Zustände
Breadcrumbs haben die gleichen interaktiven Zustände wie die Link-Komponente.
Interaktionen
Tastatur
Navigieren Sie mit der Tabulatortaste zu den Links. Aktivieren Sie die mit der EINGABE-Taste zu den Links.
Screenreader
Die ARIA-Rolle „Navigation“ und die aria-label='breadcrumb' sind enthalten, um Screenreader-Benutzern mehr Kontext zu bieten. Ähnlich verhält es sich, wenn das Kontrollkästchen „lastItemClickable“ aktiviert ist. Der letzte Link in dem Breadcrumb-Pfad nimmt dann den Wert aria-current="page" an, um die aktuelle Seite zu identifizieren.
Barrierefreiheit
Das Kontrastverhältnis von Textelementen zu ihrem Hintergrund liegt über 4,5:1 gemäß den Anforderungen der WCAG 2.1 AA. Nicht-textuelle Inhalte, die eine Bedeutung vermitteln müssen (z. B. Symbole und Sichtbarkeit des Tastaturfokus), weisen ein Kontrastverhältnis von mindestens 3:1 zu den angrenzenden Farben auf. Alle Inhalte sind bis einschließlich 400 % sichtbar und funktionsfähig, ohne dass ein Scrollen in zwei Dimensionen erforderlich ist.
Diese Komponente wurde validiert, um die Zugänglichkeitsrichtlinien WCAG 2.1 AA zu erfüllen. Vom Autor des Inhalts vorgenommene Änderungen können sich jedoch auf die Konformität mit der Barrierefreiheit auswirken.
Weitere Informationen finden Sie in der nachstehenden Anleitung sowie in den WAI-ARIA-Erstellungspraktiken für Breadcrumbs. Dazu gehören folgende Aspekte:
- Der Breadcrumb-Pfad muss auf jeder Seite an der gleichen Stelle angezeigt werden.
- Der Linktext muss klar und verständlich sein.
Code
<Breadcrumb
links={[
{
href: 'grandparent-url',
text: 'Grandparent Page',
},
{
href: 'parent-url',
text: 'Parent page',
},
{
text: 'Current Page',
},
]}
/>
Importanweisung
import { Breadcrumb } from '@jutro/router';
Komponentenvertrag
Vergewissern Sie sich, dass Sie die API-Oberfläche der Design System-Komponenten und die damit verbundenen Auswirkungen und Kompromisse verstehen. Erfahren Sie mehr in unserer Einführung zur Komponenten-API.
Eigenschaften
backLinkWithoutText
BeschreibungIf set to true, the back link will render as just an "arrow" icon. If set to false, it will also include the word "Back".
className
BeschreibungCSS class name for this component.
lastItemClickable
BeschreibungIf set to true, the last item in the breadcrumb is also a link.
links
Typ({text: IntlMessageShape, href: IntlMessageShape} & Link)[]className
BeschreibungCSS class name for this component.
href
BeschreibungURL or path for the link.
Link
BeschreibungAdditional properties from the Link component.
BeschreibungTakes an array of objects, one per each link to be displayed.
renderLinkTrigger
BeschreibungRenderProp function to generate each individual link that makes up the breadcrumbs. Uses the properties from the Link component.
Hooks
Für breadcrumb sind keine Hooks verfügbar.
Übersetzungsschlüssel
Es gibt keine Übersetzungen für breadcrumb.
Informationen über die Verwaltung von Übersetzungen finden Sie in unserem Abschnitt über Internationalisierung.
Escape Hatches
Weitere Informationen finden Sie in unserer Dokumentation über Escape-Hatches.