Beispiele
Im Abschnitt Verwendung finden Sie Informationen über das richtige Design eines Schiebereglers und die verschiedenen von Guidewire bereitgestellten Konfigurationsoptionen.
Einfaches Beispiel
Sie können einem Benutzer die Möglichkeit geben, einen numerischen Wert auszuwählen, indem Sie einen Ziehpunkt über einen Balken schieben.
<Slider
label="Slider"
secondaryLabel="Choose Value"
/>
Beispiel für Min und Max
Sie können einen Minimal- und einen Maximalwert angeben, den ein Benutzer mithilfe der Komponente auswählen kann.
<Slider
label="Slider"
secondaryLabel="Choose Value"
min={5}
max={10}
/>
Beispiel für einen Bereich
Sie können die Eigenschaft range hinzufügen, damit ein Benutzer einen Wertebereich auswählen kann. Dadurch wird ein zweiter Ziehpunkt hinzugefügt, den der Benutzer verschieben kann.
<Slider
label="Select Range"
secondaryLabel="Choose Values"
range
/>
Beispiel für einen minimalen Bereich
Sie können die Mindestgröße des Bereichs begrenzen, der vom Benutzer ausgewählt werden kann. Wenn der Benutzer versucht, einen kleineren Bereich auszuwählen, bewegt sich der andere Ziehpunkt nach Möglichkeit ebenfalls, um den Mindestabstand zwischen den beiden Punkten beizubehalten.
<Slider
label="Select Range"
secondaryLabel="Choose Values"
range
minimumRange={10}
/>
Beispiel für OnChange
Sie können eine Funktion auslösen, wenn der Wert geändert wird.
<Slider
label="Select Value"
secondaryLabel="Choose Value"
onChange={(event, value) => console.log('The value chosen is', value)}
/>
Beispiel für OnChange-Bereich
Wenn Sie den Schieberegler in den Bereichsmodus versetzen, ist der ausgegebene Wert ein Array von [minimum selected, maximum selected].
<Slider
label="Select Range"
secondaryLabel="Choose Values"
onChange={(event, value) => console.log('The values chosen are', value)}
/>
Verwendung
Überblick
Der Schieberegler ist ein Steuerelement, bei dem der Benutzer einen einzelnen Wert oder einen Wertebereich aus einem festen Satz von Optionen auswählt. Er ist eine visuelle Darstellung eines einstellbaren Werte- oder Inhaltsbereichs. Die Benutzer können einen bestimmten Wert auswählen, indem sie einen Ziehpunkt horizontal entlang einer Skala verschieben.
Zu verwenden
- Zur Auswahl eines einzelnen Wertes oder eines Wertebereichs aus einem festen Satz von Optionen.
- Wenn für den Benutzer nicht der genaue Wert wichtig ist, sondern nur der ungefähre Bereich.
Nicht zu verwenden
- Anpassung numerischer Felder um einen kleinen diskreten Betrag. Verwenden Sie stattdessen den Stepper.
- Zur Auswahl eines genauen Wertes. Verwenden Sie stattdessen die Zahleneingabe.
Quelle: Nielsen Norman
Aufbau

Der Schieberegler besteht aus den folgenden Elementen:
- Schieberegler-Beschriftung: Text, der den Zweck der Auswahlsteuerung beschreibt
- Minimalwert: der niedrigste Wert in dem Bereich, aus dem der Benutzer auswählen muss.
- Ausgefüllte Skala: Eine visuelle Anzeige, die den ausgewählten Bereich oder Fortschritt entlang des Schiebereglers von der Startposition bis zur aktuellen Position hervorhebt.
- Ziehpunkt: Element, das der Benutzer zum gewünschten Punkt im Wertebereich verschieben kann. Die ausgewählten Werte werden unterhalb des Ziehpunkts des Schiebereglers angezeigt.
- Skala: horizontale Linie, die eine Reihe von Werten darstellt, aus denen Benutzer auswählen können.
- Maximalwert: der höchste Wert in dem Bereich, aus dem der Benutzer auswählen muss.
Platzierung von Beschriftungen
Zeigen Sie die Schieberegler-Beschriftungen über oder neben dem Schieberegler an und nicht darunter, damit sie sichtbar bleiben, während der Benutzer einen Wert auswählt.

Layout und Ausrichtung
Bei Sprachen, die von links nach rechts geschrieben werden (z. B. Sprachen in lateinischer, kyrillischer, neugriechischer, indischer und südostasiatischer Schrift), erscheint der Minimalwert am linken Ende der Skala und der Maximalwert ganz rechts.
Bei Sprachen, die von rechts nach links geschrieben werden (z. B. Sprachen mit arabischer und hebräischer Schrift), ist die Ausrichtung der Werte umgekehrt.
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.
Eine Beschriftung einfügen
Verwenden Sie die Schieberegler-Beschriftung, um anzugeben, welchen Wert der Benutzer damit ändert. Die Beschriftung sollte kurz und prägnant sein. Beschränken Sie sich auf eine einzige Zeile Text.
Verwenden Sie eine Beschriftung, um anzugeben, welche Art von Wert bzw. Werten der Benutzer auswählt.
Gehen Sie nicht davon aus, dass der Schieberegler ohne Beschriftung selbsterklärend ist.
Schreiben Sie das erste Wort und Substantive groß.
Bei Schieberegler-Beschriftungen sollte die übliche Groß- und Kleinschreibung verwendet werden; sie sollten keine Interpunktionszeichen enthalten.
Weitere Informationen zum Implementieren der Groß- und Kleinschreibung finden Sie im UI-Textstyleguide.
Verwenden für die Beschriftung des Schiebereglers die übliche Groß- und Kleinschreibung.
Verwenden Sie für die Beschriftung des Schiebereglers nicht ausschließlich Großbuchstaben.
Verhalten
Zustände
Der Schieberegler kann fünf grafische Zustände annehmen, die zur Vermittlung des Status dienen: aktiviert, schwebend, aktiv, fokussiert und deaktiviert.
| Bild | Zustand | Beschreibung |
|---|
 | Aktiviert | Zeigt dem Benutzer an, dass das Element für die Interaktion aktiviert ist. |
 | Schwebend | Zeigt an, dass der Benutzer den Mauszeiger über dem Ziehpunkt des Schiebereglers platziert hat. |
 | Fokussiert | Zeigt an, dass der Benutzer auf den Ziehpunkt des Schiebereglers klickt. |
 | Aktiv | Zeigt an, dass der Schieberegler fokussiert ist und dass die Tastatur verwendet werden kann, um einen Wert auszuwählen. Der Zustand „Fokussiert“ kann mit allen anderen Zuständen (einschließlich „Deaktiviert“) verwendet werden. |
 | Deaktiviert | Teilt dem Benutzer mit, dass das Element nicht interaktiv ist. |
Interaktionen
Maus
Benutzer können einen numerischen Wert auswählen, indem sie den Ziehpunkt des Schiebereglers mit der Maus verschieben. Standardmäßig ändert sich der Wert in Einerschritten.
Sie können die step-Eigenschaft zur Steuerung der Inkremente verwenden, um die sich der Wert ändert, wenn der Benutzer den Ziehpunkt des Schiebereglers bewegt. Wenn die step-Eigenschaft festgelegt ist, ändert sich der Wert des Schiebereglers nur um Werte, die ein Vielfaches des angegebenen Schrittwerts sind. Wenn z. B. der Schieberegler einen Bereich von 0 bis 100 aufweist und die step-Eigenschaft auf 5 festgelegt wird, kann der Benutzer mit dem Schieberegler nur Werte auswählen, die Vielfache von 5 sind (0, 5, 10, 15, ..., 100). Das bedeutet, dass der Ziehpunkt des Schiebereglers beim Ziehen durch den Benutzer an diesen spezifischen Werten einrastet.
Tastatur
Der Ziehpunkt des Schiebereglers ist über die Tastatur fokussierbar. Werte können mit den Pfeiltasten erhöht und verringert werden.
Screenreader
Diese Komponente umfasst die WAI-ARIA-Rolle „Schieberegler“ und das aria-orientation-Attribut „horizontal“, um ihren Zweck und ihre Ausrichtung zu vermitteln. Der Ziehpunkt des Schiebereglers und seine Beschriftung werden über aria-labelledby verknüpft. In gleicher Weise sind die Attribute aria-valuemin, aria-valuemax und aria-valuenow enthalten, um den Benutzern von Screenreadern die Bedeutung zu vermitteln. Wertänderungen werden mittels role='alert' vermittelt.
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.
Lesen Sie unbedingt die Anleitung, auf die in den WAI-ARIA-Erstellungspraktiken für Schieberegler verwiesen wird.