棄用 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,以覆寫預設的分頁列指示器顏色。
遷移前的程式碼:
theme: ThemeData(
indicatorColor: Colors.red,
useMaterial3: false,
),
遷移後的程式碼:
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 文件:
-
ThemeData.indicatorColor -
ThemeData.useMaterial3 -
TabBarThemeData.indicatorColor -
TabBarThemeData TabBar
相關議題:
相關 PR:
Unless stated otherwise, the documentation on this site reflects Flutter 3.44.0. Page last updated on 2026-06-14. View source or report an issue.