MaterialState 重命名为 WidgetState

MaterialState 及其相关 API 已从 Material 库移出，并重命名为 WidgetState。

以前，MaterialState 提供了处理小部件可能具有的多种不同状态（如“悬停”、“聚焦”和“禁用”）的逻辑。由于此功能在 Material 库之外也很有用，尤其是在基础 Widgets 层和 Cupertino 中，因此决定将其移出 Material。作为此举的一部分，并避免将来混淆，不同的 MaterialState 类已被重命名为 WidgetState。两者行为相同。

之前	现在
`MaterialState`	`WidgetState`
`MaterialStatePropertyResolver`	`WidgetStatePropertyResolver`
`MaterialStateColor`	`WidgetStateColor`
`MaterialStateMouseCursor`	`WidgetStateColorMouseCursor`
`MaterialStateBorderSide`	`WidgetStateBorderSide`
`MaterialStateOutlinedBorder`	`WidgetStateOutlinedBorder`
`MaterialStateTextStyle`	`WidgetStateTextStyle`
`MaterialStateProperty`	`WidgetStateProperty`
`MaterialStatePropertyAll`	`WidgetStatePropertyAll`
`MaterialStatesController`	`WidgetStatesController`

MaterialStateOutlineInputBorder 和 MaterialStateUnderlineInputBorder 类保留在 Material 库中，没有 WidgetState 对应项，因为它们特定于 Material 设计。

提供了一个 Flutter fix 来帮助将 MaterialState 类迁移到 WidgetState。

要迁移，请将 MaterialState 替换为 WidgetState。

迁移前的代码

dartMaterialState selected = MaterialState.selected;

final MaterialStateProperty<Color> backgroundColor;

class _MouseCursor extends MaterialStateMouseCursor{
  const _MouseCursor(this.resolveCallback);

  final MaterialPropertyResolver<MouseCursor?> resolveCallback;

  @override
  MouseCursor resolve(Set<MaterialState> states) => resolveCallback(states) ?? MouseCursor.uncontrolled;
}

BorderSide side = MaterialStateBorderSide.resolveWith((Set<MaterialState> states) {
  if (states.contains(MaterialState.selected)) {
    return const BorderSide(color: Colors.red);
  }
  return null;
});

迁移后的代码

dartWidgetState selected = WidgetState.selected;

final WidgetStateProperty<Color> backgroundColor;

class _MouseCursor extends WidgetStateMouseCursor{
  const _MouseCursor(this.resolveCallback);

  final WidgetPropertyResolver<MouseCursor?> resolveCallback;

  @override
  MouseCursor resolve(Set<WidgetState> states) => resolveCallback(states) ?? MouseCursor.uncontrolled;
}

BorderSide side = WidgetStateBorderSide.resolveWith((Set<WidgetState> states) {
  if (states.contains(WidgetState.selected)) {
    return const BorderSide(color: Colors.red);
  }
  return null;
});

已于版本：3.21.0-11.0.pre 落地
稳定版本: 3.22.0

MaterialState 重命名为 WidgetState

概述

背景

迁移指南

时间线

参考资料