TreeView: Adaptivity
Zurück: Demo-Übersicht
1. Übersicht und Zweck
Status: [Live]. Referenz: DevExpress Baum-Adaptive-Modi.
2. Voraussetzungen
TreeView- Basiskontrakt bereits verstanden.
3. Konzepte
tree() lebt heute ausschließlich in der Sidebar-Region
(layout →
SidebarPart), die selbst per resize + overflow: auto
container-responsive ist (Zutat 5 im CSS-Rezept, s.
DataGrid →
Adaptivity). Der Baum selbst hat kein eigenes Breakpoint-Verhalten — lange
Labels brechen um oder werden vom Sidebar-overflow abgeschnitten, je
nach Sidebar-Breite.
4. Erste Schritte
Aufruf wie in der API-Referenz dokumentiert.
5. Verwendung
Relevant, sobald die Sidebar auf kollabierte Icon-Breite (s. admin-layout) reduziert wird und der Baum weiterhin nutzbar bleiben soll.
6. API-Referenz: Kollaps auf Icon-Leiste [Live]
Eine sehr schmale Sidebar (kollabierter Zustand, Marker
.wk-shell-sidebar.is-collapsed) reduziert den Baum auf reine
Icon-Knoten, statt Text abzuschneiden — reine CSS-Sichtbarkeit auf
denselben Knoten, kein separates Markup.
7. Parameter, Optionen und Zustände
| Schlüssel | Typ | Bedeutung |
|---|---|---|
$nodes[]['icon'] | string | vertrauenswürdiges HTML (.wk-tree__icon), bleibt bei kollabierter Sidebar als einziges sichtbares Element; Knoten mit Icon tragen automatisch label als title-Tooltip und aria-label am Link |
8. Vollständige Beispiele
echo $widgets->tree([ ['label' => 'Tabellen', 'href' => wl($ID, ['t' => 'x']), 'icon' => '<i class="fa fa-table"></i>'], ]);
9. Einschränkungen und Randfälle
- Knoten ohne
iconsind im kollabierten Zustand unsichtbar — Icons sind dort faktisch Pflicht (dieselbe Regel wie bei NavBar → Adaptivity).
10. Accessibility und Kompatibilität
title-Tooltips allein sind für Screenreader unzuverlässig — deshalb
setzt tree() bei Icon-Knoten label zusätzlich als aria-label
am Link (der zugängliche Name überlebt das CSS-Ausblenden des
Textknotens).
11. Troubleshooting
Symptom: Im kollabierten Zustand verschwinden Knoten komplett.
Ursache: Knoten ohne icon (s. Abschnitt 9).
Lösung: jedem Knoten ein icon geben oder den Kollaps-Zustand für
diese Sidebar nicht anbieten.
12. Verwandte Themen
- Demo-Übersicht — alle Kategorien
- DataGrid: Adaptivity — identisches Container-Prinzip beim DataGrid