Skip to main content

更新的 Material 3 進度指示器

`LinearProgressIndicator` 和 `CircularProgressIndicator` 元件（Widgets） 已更新以符合 Material 3 Design 規範。

摘要

#

LinearProgressIndicator 和 CircularProgressIndicator 已更新以符合 Material 3 Design 規範。

LinearProgressIndicator 的變更包含主動與非主動軌道之間的間隙、停止指示器，以及圓角設計。 CircularProgressIndicator 的變更包含主動與非主動軌道之間的間隙，以及圓角的描邊端點。

背景說明

#

Material 3 Design 規範針對 LinearProgressIndicator 和 CircularProgressIndicator 已於 2023 年 12 月進行更新。

若要選擇使用 2024 年的設計規範， 請將 LinearProgressIndicator.year2023 和 CircularProgressIndicator.year2023 旗標設為 false。 這麼做是為了確保現有應用程式不會受到 更新後設計規範的影響。

變更說明

#

LinearProgressIndicator 和 CircularProgressIndicator 元件 (Widget) 各自 都有一個 year2023 旗標，可設為 false 以 選擇使用更新後的設計規範。 year2023 旗標的預設值為 true，這表示 進度指示器會使用 2023 年的設計規範。

當 LinearProgressIndicator.year2023 設為 false 時， 進度指示器會在主動與非主動軌道之間顯示間隙， 並有停止指示器與圓角設計。 如果 LinearProgressIndicator 為不確定狀態（indeterminate）， 則不會顯示停止指示器。

當 CircularProgressIndicator.year2023 設為 false 時， 進度指示器會有軌道間隙與圓角的描邊端點。

遷移指南

#

若要讓 LinearProgressIndicator 選擇使用更新後的設計規範， 請將 year2023 旗標設為 false：

dart 
LinearProgressIndicator(
  year2023: false,
  value: 0.5,
),

若要將整個應用程式更新為使用新版的 LinearProgressIndicator 設計，請在您的 MaterialApp 中，將 ProgressIndicatorThemeData.year2023 屬性設為 false：

dart 
return MaterialApp(
  theme: ThemeData(progressIndicatorTheme: const ProgressIndicatorThemeData(year2023: false)),
        // ...
        LinearProgressIndicator(
          year2023: false,
          value: 0.5,
        ),
        // ...

若要讓 CircularProgressIndicator 選擇使用更新後的設計規範， 請將 year2023 旗標設為 false：

dart 
CircularProgressIndicator(
  year2023: false,
  value: 0.5,
),

若要將整個應用程式更新為使用新版的 CircularProgressIndicator 設計，請在您的 MaterialApp 中，將 ProgressIndicatorThemeData.year2023 屬性設為 false：

dart 
return MaterialApp(
  theme: ThemeData(progressIndicatorTheme: const ProgressIndicatorThemeData(year2023: false)),
        // ...
        CircularProgressIndicator(
          year2023: false,
          value: 0.5,
        ),
        // ...

時程

#

合併於版本：3.28.0-0.1.pre
正式版本：3.29

參考資料

#

API 文件：

相關議題：

相關 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.