跳到主內容

概述

#

LinearProgressIndicator 和 CircularProgressIndicator 已更新，以匹配 Material 3 設計規範。

LinearProgressIndicator 的更改包括活動和非活動軌道之間的間隙、停止指示器以及圓角。CircularProgressIndicator 的更改包括活動和非活動軌道之間的間隙以及圓角筆觸帽。

背景

#

LinearProgressIndicator 和 CircularProgressIndicator 的 Material 3 設計規範已於 2023 年 12 月更新。

要選擇加入 2024 年設計規範，請將 LinearProgressIndicator.year2023 和 CircularProgressIndicator.year2023 標誌設定為 false。這樣做是為了確保現有應用不受更新設計規範的影響。

變更說明

#

LinearProgressIndicator 和 CircularProgressIndicator 小部件都具有 year2023 標誌，可以設定為 false 來選擇加入更新的設計規範。year2023 標誌的預設值為 true，這意味著進度指示器使用的是 2023 年設計規範。

當 LinearProgressIndicator.year2023 設定為 false 時，進度指示器將在活動和非活動軌道之間有間隙、停止指示器和圓角。如果 LinearProgressIndicator 是不確定的，則不顯示停止指示器。

當 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

除非另有說明，否則本網站上的文件反映了 Flutter 的最新穩定版本。頁面最後更新於 2025-02-26。 檢視原始碼 或 報告此頁面問題。