2022年7月

在 Flutter 中，HitTestBehavior 是一个枚举类型，用于控制 手势检测 时 Widget 的命中测试行为。它通常与 IgnorePointer 或 AbsorbPointer 等 Widget 一起使用，来决定如何处理用户的触摸事件。

HitTestBehavior 有三个枚举值，分别是：

HitTestBehavior.deferToChild

HitTestBehavior.opaque
HitTestBehavior.translucent

以下是对每个枚举值的详细解释：

  1. HitTestBehavior.deferToChild

含义：将命中测试的决定权交给子 Widget。
行为：
如果子 Widget 通过了命中测试（即子 Widget 在触摸区域内），则父 Widget 也会通过命中测试。
如果子 Widget 没有通过命中测试，则父 Widget 也不会通过命中测试。
使用场景：
当希望父 Widget 的命中测试结果完全依赖于子 Widget 时使用。
例如，IgnorePointer 的默认行为就是 deferToChild。
示例

IgnorePointer(
child: Container(

width: 100,
height: 100,
color: Colors.blue,
child: Center(child: Text('Click Me')),

),
)
在这个例子中，如果用户点击了 Container，IgnorePointer 会根据子 Widget 的命中测试结果来决定是否忽略事件。

  1. HitTestBehavior.opaque

含义：父 Widget 总是通过命中测试，无论子 Widget 是否通过。
行为：
即使子 Widget 不在触摸区域内，父 Widget 也会通过命中测试。
父 Widget 会拦截所有触摸事件，子 Widget 无法接收到事件。
使用场景：
当希望父 Widget 完全拦截触摸事件时使用。
例如，AbsorbPointer 的默认行为就是 opaque。
示例

AbsorbPointer(
child: Container(

width: 100,
height: 100,
color: Colors.red,
child: Center(child: Text('Click Me')),

),
)
在这个例子中，无论用户点击哪里，AbsorbPointer 都会拦截事件，子 Widget 不会接收到任何触摸事件。

  1. HitTestBehavior.translucent

含义：父 Widget 总是通过命中测试，但子 Widget 也可以接收到事件。
行为：
父 Widget 和子 Widget 都会通过命中测试。
父 Widget 不会拦截事件，事件会同时传递给父 Widget 和子 Widget。
使用场景：
当希望父 Widget 和子 Widget 都能接收到触摸事件时使用。
例如，某些自定义手势检测场景。
示例

Listener(
behavior: HitTestBehavior.translucent,
onPointerDown: (event) {

print('Parent Widget received event');

},
child: Container(

width: 100,
height: 100,
color: Colors.green,
child: Center(
  child: Listener(
    onPointerDown: (event) {
      print('Child Widget received event');
    },
    child: Text('Click Me'),
  ),
),

),
)
在这个例子中，当用户点击 Container 时，父 Widget 和子 Widget 都会接收到事件，并分别打印日志。

总结对比

枚举值 含义 行为 使用场景
HitTestBehavior.deferToChild 将命中测试的决定权交给子 Widget。 子 Widget 通过命中测试，父 Widget 才通过；否则父 Widget 不通过。 父 Widget 的命中测试结果依赖于子 Widget。
HitTestBehavior.opaque 父 Widget 总是通过命中测试，拦截所有事件。 父 Widget 拦截所有事件，子 Widget 无法接收到事件。 父 Widget 需要完全拦截触摸事件。
HitTestBehavior.translucent 父 Widget 总是通过命中测试，但子 Widget 也可以接收到事件。 父 Widget 和子 Widget 都会接收到事件。 父 Widget 和子 Widget 都需要处理触摸事件。
实际应用场景

HitTestBehavior.deferToChild：

用于 IgnorePointer，当希望根据子 Widget 的命中测试结果来决定是否忽略事件时。
HitTestBehavior.opaque：

用于 AbsorbPointer，当希望完全拦截触摸事件时。
HitTestBehavior.translucent：

用于自定义手势检测，当希望父 Widget 和子 Widget 都能接收到事件时。
通过理解 HitTestBehavior 的枚举值及其行为，可以更好地控制 Flutter 中 Widget 的触摸事件处理逻辑。