Eingabefelder: Adaptivity
Zurück: Demo-Übersicht
1. Übersicht und Zweck
Status: [Live] — gilt für alle acht Kategorien gemeinsam. Referenz: DevExpress ASPxEditors „Adaptive Layout„.
2. Voraussetzungen
Gemeinsamer Feld-Kontrakt bereits verstanden.
3. Konzepte
Container-getrieben, wie beim DataGrid: dasselbe Prinzip wie DataGrid → Adaptivity — kein Feld kennt eigene Viewport-Breakpoints, alle folgen der Breite ihres Containers (Formular, Drawer, Auxbar).
4. Erste Schritte
echo $widgets->checkbox(['name' => 'aktiv', 'label' => 'Aktiv', 'stackBelow' => 360]);
5. Verwendung
Gilt für jedes Feld dieser Gruppe und für propertyGrid() —
derselbe Mechanismus (scripts/adaptive.js), gesteuert über den
stackBelow-Schlüssel des jeweiligen Bausteins.
6. API-Referenz: Label-Achse kippt bei schmalem Container [Live]
Die Fluent-Formularmetrik
(FluentUI: Admin-Bereich (vertieft)) positioniert Label und
Control standardmäßig nebeneinander (wie bei
propertyGrid()-Zeilen).
Mit $opts['stackBelow'] (Pixel, per ResizeObserver am
Container gemessen — nie am Viewport) kippt das Feld unterhalb dieser
Breite auf Label über Control (is-stacked-Klasse).
7. Parameter, Optionen und Zustände
| Schlüssel | Typ | Bedeutung |
|---|---|---|
stackBelow | int (px) | Container-Breite, unterhalb der Label über Control kippt (Default der JS-Schicht: 360, wenn das Attribut ohne Wert gesetzt ist) |
Dieselbe Kippe bietet propertyGrid() über sein eigenes
$opts['stackBelow'] — ein Mechanismus für beide Bausteine
(data-wk-stack-below-Attribut + scripts/adaptive.js), hier
geführt, weil Eingabefelder auch außerhalb eines propertyGrid()
vorkommen.
8. Vollständige Beispiele
echo $widgets->checkbox([ 'name' => 'aktiv', 'label' => 'Zugriff aktiv', 'stackBelow' => 300, ]);
9. Einschränkungen und Randfälle
Keine über die Feature-Seiten hinaus.
10. Accessibility und Kompatibilität
Kein ARIA-Unterschied zwischen gekippter und nebeneinander liegender Label-Achse — reines Layout, keine Semantikänderung.
11. Troubleshooting
Entfällt.
12. Verwandte Themen
- Demo-Übersicht — alle Kategorien
- DataGrid: Adaptivity — identisches Container-Prinzip beim DataGrid
- FluentUI: Vertical Grid (Property Grid) — Demo-Übersicht — Label/Control-Achse, die dieselbe Lücke teilt