Sie befinden sich hier: start » de » Interne Dokumentation » DokuWiki-Erweiterungen (WvdS) » FluentUI (Design-System-Bibliothek) » FluentUI: Komponenten-Referenzen » FluentUI: Toolbar — Demo-Übersicht » Toolbar: Accessibility

Toolbar: Accessibility

Zurück: Demo-Übersicht


1. Übersicht und Zweck

Status: [Live]. Quelle: lib/plugins/wkfluentui/scripts/toolbar.js.

2. Voraussetzungen

Toolbar-Basiskontrakt bereits verstanden.

3. Konzepte

Progressive Erweiterung, kein zweiter Code-Pfad: ohne das Skript bleibt jede Aktion ein normal per Tab erreichbares Element — dieselbe Garantie wie bei allen anderen Skripten dieser Bibliothek.

4. Erste Schritte

Kein zusätzlicher Aufruf nötig — Roving-Tabindex ist automatisch aktiv, sobald scripts/toolbar.js lädt.

5. Verwendung

Gilt automatisch für jede toolbar() mit mindestens zwei fokussierbaren Kindern.

6. API-Referenz: WAI-ARIA-Toolbar-Muster

<div class="wk-toolbar" role="toolbar"> mit mindestens zwei fokussierbaren Kindern erhält Roving-Tabindex: Pfeiltasten wechseln, welches Element tabindex=„0“ trägt (die übrigen tabindex=„-1“), Pos1/Ende springen zum ersten/letzten Element.

7. Parameter, Optionen und Zustände

Keine zusätzlichen $opts — das Verhalten hängt nur von der Anzahl fokussierbarer Kinder ab (Abschnitt 6).

Gruppen-Semantik: eine .wk-toolbar__group ohne Gruppentitel trägt bewusst keine eigene ARIA-Rolle — rein optische Trennung, Screenreader hören die Toolbar als flache Liste. Sobald eine Gruppe per groupLabel einen sichtbaren Titel trägt (Ribbon- Gruppen), erhält sie role="group" + aria-labelledby auf den Titel — ein autoritativer Gruppenname am Container (statt aria-describedby je Item, das eine Injektion in Aufrufer-HTML verlangt hätte).

8. Vollständige Beispiele

Entfällt — reine Referenzseite.

9. Einschränkungen und Randfälle

Bei nur einem fokussierbaren Item aktiviert sich Roving-Tabindex nicht — Tab erreicht das einzige Element ohnehin direkt, kein Bug.

10. Accessibility und Kompatibilität

Diese Seite ist der Accessibility-Überblick.

11. Troubleshooting

Symptom: Pfeiltasten-Navigation zwischen Toolbar-Items funktioniert nicht.

Ursache: scripts/toolbar.js wurde nicht geladen, oder die Toolbar hat weniger als zwei fokussierbare Kinder.

Lösung: Skript-Ladeweg prüfen (DOKUWIKI:include-Direktive in script.js).

12. Verwandte Themen

de/wiki/dwe/wkfluentui/component/toolbar/accessibility.txt · Zuletzt geändert: von 0.0.0.0