Bottom Navigation Title To Label

BottomNavigationBarItem.title gives a deprecation warning, or no longer exists when referenced in code.

BottomNavigationBarItems title parameter was deprecated in favor of label. This change was necessary to improve the user experience of BottomNavigationBars when the text scale factor is increased. Items in a BottomNavigationBar now show tooltips on long press. Accomplishing this requires a String parameter on BottomNavigationBarItems.

The BottomNavigationBarItem class has a title parameter, which is a Widget. This made it impossible for the BottomNavigationBar to show Tooltip widgets, a change that was necessary to improve the accessibility experience. Now, instead of building the BottomNavigationBarItem.title widget, the BottomNavigationBar wraps the BottomNavigationBarItem.label in a Text widget and builds that.

Code before migration:

BottomNavigationBarItem(
  icon: Icons.add,
  title: Text('add'),
)

Code after migration:

BottomNavigationBarItem(
  icon: Icons.add,
  label: 'add',
)

Landed in version: 1.22.0
In stable release: 2.0.0

API documentation:

• BottomNavigationBarItem

Relevant PRs:

• PR 60655: Clean up hero controller scope
• PR 59127: Update BottomNavigationBar to show tooltips on long press.

Breaking change proposal:

• Breaking Change: Bottom Navigation Item Title

Unless stated otherwise, the documentation on this site reflects the latest stable version of Flutter. Page last updated on 2024-12-16. View source or report an issue.