Skip to main content

底部导航栏标题改为标签

摘要

#

BottomNavigationBarItem.title 产生弃用警告,或在代码中引用时不再存在。

背景

#

BottomNavigationBarItemtitle 参数已被弃用,取而代之的是 label。此更改对于在文本缩放比例增大时改进 BottomNavigationBar 的用户体验是必要的。BottomNavigationBar 中的项目现在会在长按时显示工具提示。实现此功能需要 BottomNavigationBarItem 上有一个 String 参数。

更改说明

#

BottomNavigationBarItem 类具有一个 title 参数,该参数是一个 Widget。这使得 BottomNavigationBar 无法显示 Tooltip 组件,而此更改对于改进辅助功能体验是必要的。现在,BottomNavigationBar 不再构建 BottomNavigationBarItem.title 组件,而是将 BottomNavigationBarItem.label 包裹在一个 Text 组件中并构建它。

迁移指南

#

迁移前的代码:

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

迁移后的代码:

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

时间线

#

包含于版本:1.22.0
稳定版发布:2.0.0

参考

#

API 文档:

相关的 PR:

  • PR 60655: 清理 hero 控制器作用域
  • PR 59127: 更新 BottomNavigationBar 以在长按时显示工具提示。

重大更改建议: