已更新的 Material 3 进度指示器

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。

dartLinearProgressIndicator(
  year2023: false,
  value: 0.5,
),

要将整个应用更新为使用更新的 LinearProgressIndicator 设计，请在 MaterialApp 中将 ProgressIndicatorThemeData.year2023 属性设置为 false。

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

要选择加入 CircularProgressIndicator 的更新设计规范，请将 year2023 标志设置为 false。

dartCircularProgressIndicator(
  year2023: false,
  value: 0.5,
),

要将整个应用更新为使用更新的 CircularProgressIndicator 设计，请在 MaterialApp 中将 ProgressIndicatorThemeData.year2023 属性设置为 false。

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

已在版本中发布: 3.28.0-0.1.pre
稳定版发布于: 3.29

API 文档

已更新的 Material 3 进度指示器

概述

背景

变更说明

迁移指南

时间线

参考资料