Flutter中如何实现Tooltip内部交互且点击时不自动关闭

默认情况下，点击Tooltip内部区域会直接触发组件自动关闭，想在Tooltip里放可点击链接、操作按钮这类交互元素的话，常规写法会失效，常见的问题代码如下：

Tooltip(
    height: 50,
    padding: const EdgeInsets.all(80),
    richMessage: makeTooltip(context, issuerAddress, issuerName),
    child: Text('Hover me'));

InlineSpan makeTooltip(BuildContext context, String address, String name) {
    return WidgetSpan(
      child: Column(
        children: [
          GestureDetector(
            onTap: () {
              Clipboard.setData(ClipboardData(text: address));
            },
            child: Text(
              address,
            ),
          ),
          const SizedBox(height: 5),
          Text(name),
        ]),
    );
  }

这段代码运行时，点击Tooltip里的地址文本不会触发复制逻辑，点下去Tooltip直接就关了，预设的点击逻辑根本跑不到。

问题根源 #

本质是Tooltip默认内置了点击即关闭的手势逻辑，在Flutter的手势竞技场里优先级比WidgetSpan内部的GestureDetector高，点击事件先被Tooltip捕获执行关闭，内部组件拿不到完整的点击事件流，onTap自然触发不了。

解决方法 #

两种方案按需选即可：

• 轻量交互场景（比如点击复制、点击跳转）：把内部的GestureDetector换成Listener监听原始指针事件就行，Listener不参与手势竞技场竞争，不会被Tooltip的关闭逻辑拦截，改完的代码如下：

InlineSpan makeTooltip(BuildContext context, String address, String name) {
    return WidgetSpan(
      child: Column(
        children: [
          Listener(
            onPointerUp: (event) {
              // 执行复制逻辑
              Clipboard.setData(ClipboardData(text: address));
              // 如果需要操作完关闭Tooltip，手动调用全局dismiss方法即可
              Tooltip.dismissAllToolTips();
            },
            child: Text(
              address,
              style: TextStyle(color: Colors.blue, decoration: TextDecoration.underline),
            ),
          ),
          const SizedBox(height: 5),
          Text(name),
        ]),
    );
  }

• 需要保留常规交互体验（点外部关闭、点内部交互区不关闭）：给Tooltip加个配置关掉默认的点击内部即关闭逻辑即可，适合内部有多个可点击元素的场景：

Tooltip(
    height: 50,
    padding: const EdgeInsets.all(80),
    // 关闭默认点击内部关闭的逻辑
    enableTapToDismiss: false,
    richMessage: makeTooltip(context, issuerAddress, issuerName),
    child: Text('Hover me'));

注意：enableTapToDismiss是Flutter 2.10及以上版本自带的属性，低版本需要先升级SDK才能使用。

如果要在Tooltip里放输入框、多按钮这类复杂交互，别硬改Tooltip逻辑，直接用OverlayEntry手写悬浮层可控性强很多，不会遇到奇奇怪怪的手势冲突。

内容的提问来源于stack exchange，提问作者poka