忽略 IgnorePointer 和相关类中的 ignoringSemantics 的迁移指南

IgnoringPointer widget 允许您指定 UI 中的一个区域，您不希望在该区域接收指针事件，例如，当您不希望用户在文本字段中输入文本时。

以前，IgnorePointer 不仅会阻止指针事件，还会将其子树从语义树中删除。引入 ignoreSemantics 参数是为了在使用 IgnorePointers 时保留语义树而引入的变通方法。

IgnorePointer 的行为已有所改变，它不再删除整个语义子树，而只是阻止子树中的语义操作。ignoringSemantics 变通方法不再需要，并且已弃用。

此更改也适用于 AbsorbPointer 和 SliverIgnorePointer widgets。

ignoringSemantics 已被移除。

如果您在这些 widgets 中将此参数设置为 true，请考虑改用 ExcludeSemantics。

迁移前的代码

dartIgnorePointer(
  ignoringSemantics: true,
  child: const PlaceHolder(),
);

AbsorbPointer(
  ignoringSemantics: true,
  child: const PlaceHolder(),
);

SliverIgnorePointer(
  ignoringSemantics: true,
  child: const PlaceHolder(),
);

迁移后的代码

dartExcludeSemantics(
  child: IgnorePointer(
    child: const PlaceHolder(),
  ),
);

ExcludeSemantics(
  child: AbsorbPointer(
    child: const PlaceHolder(),
  ),
);

SliverIgnorePointer(
  child: ExcludeSemantics(
    child: const PlaceHolder(),
  ),
);

如果您之前在使用 IgnorePointers 并将 ignoringSemantics 设置为 false，您可以通过将以下 widget 直接复制到您的代码中并使用来达到相同的行为。

dart/// A widget ignores pointer events without modifying the semantics tree.
class _IgnorePointerWithSemantics extends SingleChildRenderObjectWidget {
  const _IgnorePointerWithSemantics({
    super.child,
  });

  @override
  _RenderIgnorePointerWithSemantics createRenderObject(BuildContext context) {
    return _RenderIgnorePointerWithSemantics();
  }
}

class _RenderIgnorePointerWithSemantics extends RenderProxyBox {
  _RenderIgnorePointerWithSemantics();

  @override
  bool hitTest(BoxHitTestResult result, { required Offset position }) => false;
}

/// A widget absorbs pointer events without modifying the semantics tree.
class _AbsorbPointerWithSemantics extends SingleChildRenderObjectWidget {
  const _AbsorbPointerWithSemantics({
    super.child,
  });

  @override
  _RenderAbsorbPointerWithSemantics createRenderObject(BuildContext context) {
    return _RenderAbsorbPointerWithSemantics();
  }
}

class _RenderAbsorbPointerWithSemantics extends RenderProxyBox {
  _RenderAbsorbPointerWithSemantics();

  @override
  bool hitTest(BoxHitTestResult result, { required Offset position }) {
    return size.contains(position);
  }
}

/// A sliver ignores pointer events without modifying the semantics tree.
class _SliverIgnorePointerWithSemantics extends SingleChildRenderObjectWidget {
  const _SliverIgnorePointerWithSemantics({
    super.child,
  });

  @override
  _RenderSliverIgnorePointerWithSemantics createRenderObject(BuildContext context) {
    return _RenderSliverIgnorePointerWithSemantics();
  }
}

class _RenderSliverIgnorePointerWithSemantics extends RenderProxySliver {
  _RenderSliverIgnorePointerWithSemantics();

  @override
  bool hitTest(BoxHitTestResult result, { required Offset position }) => false;
}

已于版本：3.10.0-2.0.pre 落地
在稳定版中发布: 3.13.0

忽略 IgnorePointer 和相关类中的 ignoringSemantics 的迁移指南

概述

变更说明

迁移指南

时间线

参考资料