Flutter ReorderableDragStartListener移动端手势识别异常求助

移动端存在手势识别优先级冲突：ReorderableListView的垂直滚动手势默认优先级高于自定义拖拽手柄的拖拽手势。直接上下拖动时，滚动事件被优先捕获，导致无法触发拖拽排序；左右滑动时滚动手势不触发，拖拽手势才会被识别。

方案1：提升拖拽手柄的手势优先级 #

用GestureDetector包裹ReorderableDragStartListener，设置behavior: HitTestBehavior.opaque，确保拖拽手柄区域的手势被优先处理：

GestureDetector(
  behavior: HitTestBehavior.opaque,
  child: ReorderableDragStartListener(
    index: index,
    child: Icon(Icons.drag_handle), // 你的自定义拖拽手柄
  ),
)

方案2：自定义手势识别器强制优先响应拖拽 #

通过RawGestureDetector实现自定义手势识别器，直接抢占滚动手势的响应权：

RawGestureDetector(
  gestures: {
    _DragPriorityRecognizer: GestureRecognizerFactoryWithHandlers<_DragPriorityRecognizer>(
      () => _DragPriorityRecognizer(),
      (instance) {
        instance.onDragStart = (details) {
          ReorderableListView.of(context).startDrag(index);
        };
      },
    ),
  },
  child: Icon(Icons.drag_handle),
)

// 自定义手势识别器，优先响应拖拽
class _DragPriorityRecognizer extends OneSequenceGestureRecognizer {
  VoidCallback? onDragStart;

  @override
  void addPointer(PointerDownEvent event) {
    startTrackingPointer(event.pointer);
    resolve(GestureDisposition.accepted); // 直接接受手势，阻止滚动触发
    onDragStart?.call();
  }

  @override
  String get debugDescription => 'priority_drag_recognizer';

  @override
  void didStopTrackingLastPointer(int pointer) {}
}

方案3：拖拽时临时禁用列表滚动 #

通过状态变量控制列表的滚动物理特性，按下拖拽手柄时禁用滚动，结束后恢复：

bool _dragging = false;

@override
Widget build(BuildContext context) {
  return ReorderableListView(
    physics: _dragging ? NeverScrollableScrollPhysics() : AlwaysScrollableScrollPhysics(),
    buildDefaultDragHandles: false,
    onReorder: (oldIndex, newIndex) {
      // 处理列表重排逻辑
      setState(() {
        // 更新列表数据
      });
    },
    children: yourListItems.map((item) {
      final index = yourListItems.indexOf(item);
      return ListTile(
        key: Key(item.id),
        title: Text(item.title),
        trailing: GestureDetector(
          onPanDown: (_) => setState(() => _dragging = true),
          onPanEnd: (_) => setState(() => _dragging = false),
          child: ReorderableDragStartListener(
            index: index,
            child: Icon(Icons.drag_handle),
          ),
        ),
      );
    }).toList(),
  );
}

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