Skip to main content

已更新的 Material 3 Slider

`Slider` 元件(Widget)已更新,以符合 Material 3 Design(Material 3 設計)規範。

摘要

#

Slider 已更新,以符合 Material 3 Design(Material 3 設計)規範。

Slider 的變更包括更新的高度、 主動與非主動軌道之間的間隙,以及 一個用於顯示非主動軌道結束值的停止指示器。 按下滑塊(thumb)時會調整其寬度,軌道也會調整形狀。 新的值指示器(value indicator)形狀為圓角矩形。 部分 Slider 形狀也引入了新的顏色對應。

背景

#

Material 3 Design(Material 3 設計)規範針對 Slider 於 2023 年 12 月進行了更新。 若要選用 2024 年的設計規範,請將 Slider.year2023 旗標設為 false。 這麼做是為了確保現有應用程式不會受到 新設計規範的影響。

變更說明

#

Slider 元件(Widget)具有 year2023 旗標,可設為 false 以採用更新後的設計規範。 year2023 旗標的預設值為 true, 這表示 Slider 會使用先前 2023 年的設計規範。

Slider.year2023 設為 false 時, 滑桿(slider)將會使用更新後的設計規範。

遷移指南

#

若要讓 Slider 採用更新後的設計規範, 請將 year2023 旗標設為 false

dart
Slider(
  year2023: false,
  value: _value,
  onChanged: (value) {
    setState(() {
      _value = value;
    });
  },
),

若要將整個應用程式更新為使用新版的 Slider 設計,請在 MaterialApp 中將 SliderThemeData.year2023 屬性設為 false

dart
return MaterialApp(
  theme: ThemeData(sliderTheme: const SliderThemeData(year2023: false)),
        // ...
        Slider(
          value: _value,
          onChanged: (value) {
            setState(() {
              _value = value;
            });
          },
        ),
        // ...

時程

#

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

參考資料

#

API 文件:

相關議題:

相關 PR: