statesController property

Represents the interactive "state" of this widget in terms of a set of MaterialStates, including MaterialState.disabled, MaterialState.hovered, MaterialState.error, and MaterialState.focused.

Classes based on this one can provide their own MaterialStatesController to which they've added listeners. They can also update the controller's MaterialStatesController.value however, this may only be done when it's safe to call State.setState, like in an event handler.

The controller's MaterialStatesController.value represents the set of states that a widget's visual properties, typically MaterialStateProperty values, are resolved against. It is not the intrinsic state of the widget. The widget is responsible for ensuring that the controller's MaterialStatesController.value tracks its intrinsic state. For example one cannot request the keyboard focus for a widget by adding MaterialState.focused to its controller. When the widget gains the or loses the focus it will MaterialStatesController.update its controller's MaterialStatesController.value and notify listeners of the change.