MultiSelect<T> class

A keyboard-navigable list of checkable options.

Controlled: hold values yourself and update them from onChanged. Enter, Space, or a click toggles the highlighted option. Disabled options remain visible but cannot be toggled. Passing null for onChanged disables the whole widget.

Inheritance

• Object
• Widget
• StatefulWidget
• MultiSelect

Available extensions

• AnimateExtension

Constructors

MultiSelect({Key? key, required List<SelectOption<T>> options, required Set<T> values, required void onChanged(Set<T> values)?, String semanticLabel = 'Multi-select', String emptyLabel = 'No options', FocusNode? focusNode, bool autofocus = false, CellStyle? style})

const

Properties

autofocus → bool

Whether the list requests focus when mounted.

final

emptyLabel → String

Text rendered when options is empty.

final

focusNode → FocusNode?

Optional externally owned focus node used for keyboard navigation.

final

hashCode → int

The hash code for this object.

no setter, inherited

key → Key?

final, inherited

onChanged → void Function(Set<T> values)?

Called with a new unmodifiable selection after a toggle; null disables it.

final

options → List<SelectOption<T>>

Ordered choices; disabled options remain visible but cannot be toggled.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

semanticLabel → String

Label exposed for the option list through the semantic app graph.

final

style → CellStyle?

Base styling for each option row, plus optional hover, focus, selected, disabled, and invalid state entries from CellStyle.interactive.

final

values → Set<T>

Controlled set of currently selected option values.

final

Methods

animate({Duration? duration, Curve? curve, Object? trigger, bool repeat = false}) → Animate

Available on Widget, provided by the AnimateExtension extension

Starts an Animate chain over this widget. duration / curve apply to the whole chain. With no trigger it plays on mount; with a non-null trigger it rests on mount and replays whenever the token changes.

createElement() → StatefulElement

Creates the Element that will mount this widget into the tree.

inherited

createState() → State<MultiSelect<T>>

Creates the mutable state for this widget at the current location in the tree. Called exactly once per StatefulElement instance.

override

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited