内容

将 MaterialState 重命名为 WidgetState

内容

摘要
背景
迁移指南
时间线
参考文献

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

以前，MaterialState 提供了用于处理部件可能具有的多种不同状态的逻辑，例如“悬停”、“聚焦”和“禁用”。由于此功能在 Material 库之外也很有用，即对于基本部件层和 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修复来帮助将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

摘要

背景

迁移指南

时间线

参考文献