原文为 2022 年桌面端手势实践,按当前 API 文档修订回调解释。
GestureDetector 适合给已有组件添加点击、长按或拖动行为。Material 风格按钮若需要水波纹、键盘与语义行为,可直接使用按钮组件;GestureDetector 用于需要自定义识别的交互区域。
点击与命中区域
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 用于获取位置。取消回调反映识别失败或取消,不应简单等同于“手指移出了组件”。
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 的局部坐标,避免嵌套布局的偏移影响位置。
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 控制,与组件自己的拖动回调是两个层次。旧项目需要开启该行为时,可以只在相关列表外包一层配置。
ScrollConfiguration(
behavior: ScrollConfiguration.of(context).copyWith(
dragDevices: {
...ScrollConfiguration.of(context).dragDevices,
PointerDeviceKind.mouse,
},
),
child: ListView(children: items),
)
这段代码需导入 package:flutter/gestures.dart。鼠标拖动列表会和文本选择等桌面交互竞争,配置范围应跟随具体功能。


