弃用 `ThemeData.dialogBackgroundColor`，转而使用 `DialogThemeData.backgroundColor`

ThemeData.dialogBackgroundColor 参数已弃用，转而使用 DialogThemeData.backgroundColor 参数。

Dialog 和 AlertDialog 小部件的默认设置可以使用诸如 DialogThemeData 等特定组件主题进行覆盖。以前，ThemeData.dialogBackgroundColor 参数用于覆盖默认对话框背景颜色，但该参数已被 DialogThemeData 替代，变得多余。

ThemeData.dialogBackgroundColor 已弃用，取而代之的是组件特定主题。使用 DialogThemeData 来覆盖默认背景颜色。

将 ThemeData.dialogBackgroundColor 替换为 DialogThemeData.backgroundColor 以覆盖默认对话框背景颜色。

迁移前的代码

theme: ThemeData(
  dialogBackgroundColor: Colors.orange,
),

迁移后的代码

theme: ThemeData(
  dialogTheme: const DialogThemeData(backgroundColor: Colors.orange),
),

已在版本中发布: 3.28.0-0.1.pre
稳定版发布于: 3.29

API 文档

• ThemeData.dialogBackgroundColor
• DialogThemeData.backgroundColor
• DialogThemeData
• Dialog
• AlertDialog

相关问题

• 问题 #91772

相关 PR

• 弃用 ThemeData.dialogBackgroundColor，转而使用 DialogTheme.backgroundColor