Suchbare Mehrfachauswahl mit Tags. Alle auswählen betrifft die geladenen Ergebnisse.
TxTagBox
| Parameter | Typ | Standard | Bedeutung |
|---|---|---|---|
| items | List<TxItem<T>> | const [] | Einträge; bei Datenbindung durch dataSource ersetzt. |
| dataSource | Object? | null | Liste, Konfiguration oder DataSource-Instanz; hat Vorrang vor items. |
| values | Set<T> | const {} | Aktuell ausgewählte Werte. |
| onChanged | ValueChanged<Set<T>>? | null | Callback für changed; Argumente und Rückgabetyp siehe Signatur. |
| disabled | bool | false | Sperrt die Interaktion. |
| label | String | 'Auswählen' | Beschriftung beziehungsweise zugänglicher Name. |
| maxDisplayedTags | int | 4 | Maximal sichtbare Tags vor der Zusammenfassung. |
| applyOnConfirm | bool | false | Übernimmt die Auswahl erst bei Bestätigung. |
| onCustomItemCreating | FutureOr<TxItem<T>> Function(String)? | null | Erzeugt synchron oder asynchron einen TxItem aus dem eingegebenen Text. |
| showSelectionControls | bool | true | Zeigt Mehrfachauswahl-/Alle-Steuerelemente. |
import 'package:flutter/material.dart';
import 'package:tecexpress/tecexpress.dart';
Widget example() {
const options = [TxItem(value: 1, text: 'One'), TxItem(value: 2, text: 'Two')];
var keys = <int>{};
return StatefulBuilder(
builder: (context, setState) => TxTagBox<int>(items: options, values: keys, onChanged: (v) => setState(() => keys = v)),
);
}