Skip to main content

棄用 ThemeData.indicatorColor,改用 TabBarThemeData.indicatorColor

`ThemeData.indicatorColor` 參數已被 `TabBarThemeData.indicatorColor` 取代。

摘要

#

ThemeData.indicatorColor 參數已被棄用,建議改用 TabBarThemeData.indicatorColor 參數。

背景說明

#

TabBar 元件 (Widget) 的預設值可以透過像 TabBarThemeData 這樣的元件專屬主題(component-specific theme)來覆寫。 過去,ThemeData.indicatorColor 參數用於在 Material Design 2 中覆寫預設的分頁列指示器顏色,但這個功能已被 TabBarThemeData 取代,因此變得多餘。

變更說明

#

ThemeData.indicatorColor 已被棄用,建議改用元件專屬主題。 請使用 TabBarThemeData 來覆寫預設的指示器顏色。

遷移指南

#

ThemeData.useMaterial3 旗標(flag)設為 false 時,請將 ThemeData.indicatorColor 替換為 TabBarThemeData.indicatorColor,以覆寫預設的分頁列指示器顏色。

遷移前的程式碼:

dart
theme: ThemeData(
  indicatorColor: Colors.red,
  useMaterial3: false,
),

遷移後的程式碼:

dart
theme: ThemeData(
  tabBarTheme: const TabBarThemeData(indicatorColor: Colors.red),
  useMaterial3: false,
),

時程

#

Landed in version: 3.30.0-0.0.pre
In stable release: 3.32

參考資料

#

API 文件:

相關議題:

相關 PR: