Toolbar: Adaptivity
Zurück: Demo-Übersicht
1. Übersicht und Zweck
Status: [Live]. Referenz: ActionBar/ToolBar-Zeile im
Widget-Katalog (Zustand
„responsive-overflow„ bereits im Zustands-Vokabular vorgesehen, aber nicht
umgesetzt).
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