ThemeData.useMaterial3 标志默认值为 true
概述
#Material 库已更新,以匹配最新的 Material Design 规范。更改包括新的组件、新的组件主题和更新的组件视觉效果。自此版本发布以来,ThemeData.useMaterial3
默认设置为 true
。
背景
#Flutter 的 Material 组件现已完全支持 Material 3,并且自 Flutter 3.16 起,Material 3 已成为默认样式。
Material 3 组件的外观主要由 ThemeData.colorScheme
和 ThemeData.textTheme
的值决定。ColorScheme 使创建深色和浅色主题更加容易,从而使您的应用既美观又符合可访问性要求。要进一步自定义 Material 3 组件的外观,请将组件主题添加到您的 ThemeData
中,例如 ThemeData.segmentedButtonTheme
或 ThemeData.snackBarTheme
。
此外,Material 3 通过使用缓动和持续时间令牌来改进动画效果。这意味着 Material 2 的曲线已被重命名,以包含“legacy”一词,并且最终将被弃用和移除。
请查看 Material 3 gallery 来测试所有新组件并将其与 Material 2 进行比较。
迁移指南
#在 3.16 版本发布之前,这些更改是“选择加入”的,通过在 ThemeData
上使用 useMaterial3
主题属性。自此版本发布以来,useMaterial3
默认设置为 true
。您仍然可以通过在 MaterialApp
主题中指定 useMaterial3: false
来选择退出 Material 3 版本的 Material 库。
此外,一些组件无法简单地更新,而是需要全新的实现。因此,当您看到 Material 3 运行时,您的 UI 可能会显得有些奇怪。要解决此问题,请手动迁移到新组件,例如 NavigationBar
。
有关更多详细信息,请查看 GitHub 上的 Material 3 汇总问题。
时间线
#已于版本中发布:3.13.0-4.0.pre
稳定版本:3.16
参考资料
#文档
API 文档
相关问题
相关 PR