棄用 `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),
),

已在版本中推出：v3.27.0-0.1.pre
在穩定版本中：待定

API 文件

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

相關議題

• Issue #91772

相關的 PR

• 棄用 `ThemeData.dialogBackgroundColor`，改用 `DialogTheme.backgroundColor`

除非另有說明，否則本網站上的文件反映了 Flutter 的最新穩定版本。頁面最後更新時間為 2024-10-24。 檢視原始碼 或 回報問題。