ThemeData 的 toggleableActiveColor 属性已弃用

Material 部件 `Switch`、`SwitchListTile`、`Checkbox`、`CheckboxListTile`、`Radio`、`RadioListTile` 现在为其可切换部件使用 `ColorScheme.secondary` 颜色。`ThemeData.toggleableActiveColor` 已弃用，并最终将被移除。

依赖于 `ThemeData.toggleableActiveColor` 的部件迁移到 `ColorScheme.secondary` 使得 `toggleableActiveColor` 属性变得不必要。根据 Flutter 的弃用策略，此属性最终将被移除。

之前使用 `ThemeData.toggleableActiveColor` 颜色表示活动/选中状态的部件，现在使用 `ColorScheme.secondary`。

可切换部件的活动/选中颜色通常可以通过 3 种方式进行自定义：

使用 `ThemeData` 的 `ColorScheme.secondary`。
使用组件主题 `SwitchThemeData`、`ListTileThemeData`、`CheckboxThemeData` 和 `RadioThemeData`。
通过自定义部件的颜色属性。

迁移前的代码

dartMaterialApp(
  theme: ThemeData(toggleableActiveColor: myColor),
  // ...
);

迁移后的代码

dartfinal ThemeData theme = ThemeData();
MaterialApp(
  theme: theme.copyWith(
    switchTheme: SwitchThemeData(
      thumbColor: MaterialStateProperty.resolveWith<Color?>(
          (Set<MaterialState> states) {
        if (states.contains(MaterialState.disabled)) {
          return null;
        }
        if (states.contains(MaterialState.selected)) {
          return myColor;
        }
        return null;
      }),
      trackColor: MaterialStateProperty.resolveWith<Color?>(
          (Set<MaterialState> states) {
        if (states.contains(MaterialState.disabled)) {
          return null;
        }
        if (states.contains(MaterialState.selected)) {
          return myColor;
        }
        return null;
      }),
    ),
    radioTheme: RadioThemeData(
      fillColor: MaterialStateProperty.resolveWith<Color?>(
          (Set<MaterialState> states) {
        if (states.contains(MaterialState.disabled)) {
          return null;
        }
        if (states.contains(MaterialState.selected)) {
          return myColor;
        }
        return null;
      }),
    ),
    checkboxTheme: CheckboxThemeData(
      fillColor: MaterialStateProperty.resolveWith<Color?>(
          (Set<MaterialState> states) {
        if (states.contains(MaterialState.disabled)) {
          return null;
        }
        if (states.contains(MaterialState.selected)) {
          return myColor;
        }
        return null;
      }),
    ),
  ),
  //...
)

稳定版发布于: 3.7

API 文档

ThemeData 的 toggleableActiveColor 属性已弃用

概述

背景

变更说明

迁移指南

时间线

参考资料