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
- Demo-Übersicht – alle Kategorien
- Tab Control: Adaptivity – identisches Overflow-Prinzip