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
- Demo-Übersicht — alle Kategorien
- Tab Control: Accessibility — verwandtes Roving-Tabindex-Muster