Farbschema: Hell
Sie befinden sich hier: start » de » Dokumentation » DokuWiki-Erweiterungen (WvdS) » FluentUI (Design-System-Bibliothek) » FluentUI: Komponenten-Referenzen » FluentUI: Toolbar – Demo-Übersicht » Toolbar: Adaptivity

Toolbar: Adaptivity

Zurück: Demo-Übersicht


Wie sich eine Werkzeugleiste bei wenig Platz verhält: Einträge, die nicht mehr nebeneinander passen, wandern hinter einen Knopf „Weitere Aktionen“ und bleiben von dort aus erreichbar.

1. Übersicht und Zweck

Status: [Live]. Referenz: ActionBar/ToolBar-Zeile im Widget-Katalog. Der Zustand „responsive-overflow“ des Vokabulars ist als Opt-in umgesetzt ('overflow' => true plus scripts/toolbar.js); ohne die Angabe bricht die Leiste um, statt zu falten.

Beispiel Befehlsleiste des Tresors: bei 1400 px stehen fünf Bedienelemente nebeneinander und es gibt keinen Überlaufknopf; bei 390 px tragen beide Gruppen hidden, sichtbar bleibt ein Knopf, und „Weitere Aktionen“ führt die übrigen.

2. Voraussetzungen

Toolbar-Basiskontrakt bereits verstanden.

3. Konzepte

Dasselbe Overflow-Prinzip wie bei Tab Control → Adaptivity, hier auf Toolbar-Items statt Tab-Köpfe angewendet.

4. Erste Schritte

echo $widgets->toolbar($items, ['ariaLabel' => 'Aktionen', 'overflow' => true]);

5. Verwendung

Relevant für Toolbars mit vielen Items in schmalen Panels. Opt-in über $opts['overflow'] – bestehende Toolbars (z. B. die Bulkbar) behalten bewusst ihr Umbruchverhalten.

6. API-Referenz: Overflow in Kontextmenü [Live]

Unterhalb verfügbarer Breite (ResizeObserver, scripts/toolbar.js) verschwinden die am weitesten rechts stehenden Items hinter einem „Weitere Aktionen“-Button (.wk-toolbar__more), der ein Menü im Kontextmenü-Look öffnet (role=„menu“/menuitem); ein Menü-Eintrag klickt das echte, versteckte Element – ein Code-Pfad.

7. Parameter, Optionen und Zustände

Schlüssel Typ Bedeutung
$opts['overflow'] bool schaltet das Overflow-Verhalten ein (Default aus)

No-JS-Fallback: alle Items bleiben sichtbar und brechen um (flex-wrap), kein Overflow-Menü ohne JavaScript.

8. Vollständige Beispiele

Siehe Abschnitt 4.

9. Einschränkungen und Randfälle

  • Selects/Inputs im Overflow-Menü werden als klickende Einträge gelistet – für komplexe Controls das Overflow-Verhalten nicht aktivieren.

10. Accessibility und Kompatibilität

Das „Weitere Aktionen“-Menü muss tastaturbedienbar sein – dasselbe Muster wie das bestehende Kontextmenü.

11. Troubleshooting

Entfällt.

12. Verwandte Themen

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