M3EFocusInteraction class
Tracks whether keyboard focus rings are allowed after the last interaction.
Any pointer interaction (hover, press, scroll, or pan) clears rings. Only keyboard focus-navigation keys enable them again. Focus on nodes is unchanged — only ring visibility is gated.
- Inheritance
-
- Object
- ChangeNotifier
- M3EFocusInteraction
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- hasListeners → bool
-
Whether any listeners are currently registered.
no setterinherited
- listenable → Listenable
-
Listenable for rebuilds when ringsAllowed changes.
no setter
- ringsAllowed → bool
-
Whether keyboard focus rings may paint.
no setter
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
addListener(
VoidCallback listener) → void -
Register a closure to be called when the object changes.
inherited
-
dispose(
) → void -
Discards any resources used by the object.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
noteKeyboardHighlight(
) → void - Call when keyboard focus navigation becomes active (Tab / arrows).
-
notePointerInteraction(
{bool immediate = false}) → void - Call when a pointer interaction starts so rings hide until keyboard nav.
-
notifyListeners(
) → void -
Call all the registered listeners.
inherited
-
removeListener(
VoidCallback listener) → void -
Remove a previously registered closure from the list of closures that are
notified when the object changes.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Properties
- instance → M3EFocusInteraction
-
Shared process-wide interaction modality for focus rings.
final
Static Methods
-
ensureVisibleIfKeyboard(
BuildContext context, {double alignment = 0.5, Duration duration = const Duration(milliseconds: 120), Curve curve = Curves.easeOut}) → void - Ensures the focused widget is visible when keyboard rings are active.
-
resetForTest(
) → void -
Resets singleton state for widget tests. Call from
addTearDown.