Eingabefelder: List editors

1. Übersicht und Zweck

Status: [Live]. Referenz: DevExpress ASPxListBox (Einzel-/Mehrfachauswahl-Liste) und ASPxCheckBoxList (Checkbox-Gruppe).

2. Voraussetzungen

Gemeinsamer Feld-Kontrakt bereits verstanden.

3. Konzepte

Zwei Darstellungen, ein Datenmodell: beide Varianten nehmen dieselbe options-Struktur wie Combo Box entgegen — der Unterschied ist reine Darstellung.

4. Erste Schritte

echo $widgets->listEditor([
    'name'    => 'module',
    'label'   => 'Sichtbare Module',
    'multi'   => true,
    'display' => 'checkboxes',
    'value'   => ['wiki', 'blog'],
    'options' => [
        ['value' => 'wiki', 'label' => 'Wiki'],
        ['value' => 'blog', 'label' => 'Blog'],
        ['value' => 'pqcrypt', 'label' => 'PQ-Crypto'],
    ],
]);

5. Verwendung

`$opts['display']`	Natives Control	Einsatz
`list` (Default)	`<select multiple>` (bei `multi ⇒ true`) bzw. `<select>`	kompakte Liste, viele Optionen
`checkboxes`	Gruppe von `<input type="checkbox">` (bzw. `radio` bei `multi ⇒ false`)	wenige Optionen, alle gleichzeitig sichtbar gewünscht

6. API-Referenz

Methode listEditor(array $opts): string in helper_plugin_wkfluentui_widgets.

7. Parameter, Optionen und Zustände

Schlüssel	Typ	Bedeutung
`options`	array	wie bei Combo Box
`multi`	bool	Mehrfachauswahl, Default `false`
`display`	`'list'\|'checkboxes'`	s. Abschnitt 5
`selectAllToggle`	bool	bei `display => 'checkboxes', multi => true`: zusätzliche „Alle auswählen„-Kopf-Checkbox (Analog zur Kopf-Checkbox von dataGrid() Selection — dasselbe Muster, ein zweites Mal angewendet)

8. Vollständige Beispiele

echo $widgets->listEditor([
    'name'    => 'rollen',
    'label'   => 'Rollen',
    'multi'   => true,
    'display' => 'list',
    'options' => $verfuegbareRollen,
]);

9. Einschränkungen und Randfälle

Keine über die Feature-Seiten hinaus.

10. Accessibility und Kompatibilität

Vollständiger Überblick: Accessibility.

11. Troubleshooting

Entfällt.

12. Verwandte Themen

Demo-Übersicht — alle Kategorien
Eingabefelder: Check box — einzelne Checkbox statt Gruppe
DataGrid: Selection — verwandtes Kopf-Checkbox-Muster