The Visibility widget is no longer focusable by default when maintainState is enabled

This change was introduced to fix an issue where an IndexedStacks hidden children would be focusable with keyboard events (see issue) due to the underlying Visibility widgets default behavior.

The core change is the Visibility widget is no longer focusable by default when maintainState is enabled. A new flag, maintainFocusability, must be set to true with maintainState for a hidden widget to remain focusable.

If your app has a Visibility widget that does not set maintainState to true, then no changes are required.

If your app has a Visibility widget that sets maintainState to true and you relied on the previous default behavior that allowed you to focus your hidden widget, you will need to set maintainFocusability to true.

Code before migration:

child: Visibility(
    maintainState: true,
    child: SomeWidget(),
)

Code after migration:

child: Visibility(
    maintainState: true,
    maintainFocusability: true,
    child: SomeWidget(),
)

Landed in version: 3.34.0-pre
In stable release: 3.35

API documentation:

• Visibility

Relevant issues:

• Issue 114213

Relevant PRs:

• PR 159133: Add flag to exclude focus for hidden children in Visibility, maintainFocusability. Set maintainFocusability to false in IndexedStack