Flutter GestureDetector:点击、长按与桌面交互

整理手势回调、命中区域、右键菜单和桌面鼠标拖动的常见用法。

适用版本

原文为 2022 年桌面端手势实践,按当前 API 文档修订回调解释。

本文目录
  1. 点击与命中区域
  2. 长按与拖动
  3. 桌面右键菜单
  4. 鼠标拖动列表
  5. 参考与源码

GestureDetector 适合给已有组件添加点击、长按或拖动行为。Material 风格按钮若需要水波纹、键盘与语义行为,可直接使用按钮组件;GestureDetector 用于需要自定义识别的交互区域。

点击与命中区域

dart
GestureDetector(
  behavior: HitTestBehavior.opaque,
  onTap: () => FocusScope.of(context).unfocus(),
  child: const Padding(
    padding: EdgeInsets.all(24),
    child: Text('点击此区域收起键盘'),
  ),
)

opaque 使组件自身边界内的空白区域参与命中。它不会改变组件大小,也不会强制父子两个手势识别器同时收到 onTap。父子都识别点击时,仍由手势竞技场决定谁获胜。

onTapDown 提供按下坐标;成功识别后可以收到 onTapUp 与 onTap;没有完成点击则可能收到 onTapCancel。不能把按下回调当作用户已经完成了操作。

长按与拖动

长按用 onLongPress 完成主要动作,onLongPressStart 和 onLongPressMoveUpdate 用于获取位置。取消回调反映识别失败或取消,不应简单等同于“手指移出了组件”。

dart
GestureDetector(
  onVerticalDragUpdate: (details) {
    setState(() {
      panelHeight = (panelHeight - details.delta.dy)
          .clamp(120.0, 480.0).toDouble();
    });
  },
  child: const SizedBox(
    height: 40,
    child: Center(child: Text('上下拖动')),
  ),
)

仅处理垂直方向时使用 onVerticalDrag*,水平方向使用 onHorizontalDrag*。onPan* 处理二维拖动,不和水平、垂直拖动识别器同时配置在同一个 GestureDetector 中。

桌面右键菜单

右键位置来自 onSecondaryTapDown。菜单定位需要转换为 Overlay 的局部坐标,避免嵌套布局的偏移影响位置。

dart
onSecondaryTapDown: (details) {
  final overlay = Overlay.of(context).context.findRenderObject() as RenderBox;
  final point = overlay.globalToLocal(details.globalPosition);
  showMenu<String>(
    context: context,
    position: RelativeRect.fromRect(
      Rect.fromLTWH(point.dx, point.dy, 0, 0),
      Offset.zero & overlay.size,
    ),
    items: const [
      PopupMenuItem(value: 'open', child: Text('打开')),
      PopupMenuItem(value: 'copy', child: Text('复制名称')),
    ],
  );
},

鼠标拖动列表

列表是否接受鼠标拖动由 ScrollBehavior 控制,与组件自己的拖动回调是两个层次。旧项目需要开启该行为时,可以只在相关列表外包一层配置。

dart
ScrollConfiguration(
  behavior: ScrollConfiguration.of(context).copyWith(
    dragDevices: {
      ...ScrollConfiguration.of(context).dragDevices,
      PointerDeviceKind.mouse,
    },
  ),
  child: ListView(children: items),
)

这段代码需导入 package:flutter/gestures.dart。鼠标拖动列表会和文本选择等桌面交互竞争,配置范围应跟随具体功能。

参考与源码

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。