Flutter如何屏蔽TextFormField内的水平滑动触发页面切换？

方案一：子页面拦截水平手势 #

在包含TextFormField的子页面（AuthorPage/DesignerPage）根节点外包裹GestureDetector，拦截水平拖动事件，阻止事件传递到父级：

class AuthorPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      // 拦截水平拖动，不执行任何操作，消耗事件流
      onHorizontalDragUpdate: (_) {},
      behavior: HitTestBehavior.opaque,
      child: Scaffold(
        // 原页面内容，包含TextFormField
        body: Column(
          children: [
            TextFormField(decoration: InputDecoration(hintText: "输入内容")),
            // 其他组件
          ],
        ),
      ),
    );
  }
}

对DesignerPage做相同修改即可。此时在TextFormField上的水平拖动会被子页面的GestureDetector处理，父级的页面切换逻辑不会触发。

方案二：调整父级手势识别优先级 #

替换父级的onPanUpdate为onHorizontalDragUpdate，并设置手势识别器优先级，让子组件手势优先处理：

class _MainPageState extends State<MainPage> {
  SwipeController swipeController = Get.put(SwipeController());

  @override
  Widget build(BuildContext context) {
    return Obx(() {
      return GestureDetector(
        onHorizontalDragUpdate: (details) {
          // 添加阈值过滤小幅度拖动
          if (details.delta.dx > 10) {
            swipeController.index.value = 0;
          } else if (details.delta.dx < -10) {
            swipeController.index.value = 1;
          }
        },
        gestureRecognizers: {
          Factory<HorizontalDragGestureRecognizer>(
            () => HorizontalDragGestureRecognizer()
              ..startBehavior = HitTestBehavior.deferToChild,
          ),
        },
        child: swipeController.index.value == 0 ? AuthorPage() : DesignerPage(),
      );
    });
  }
}

HitTestBehavior.deferToChild让父级手势识别器等待子组件处理事件，只有子组件未处理（如空白区域滑动）时，父级切换逻辑才会触发。

方案三：添加拖动阈值（快速缓解） #

如果不想修改子页面，可在父级onPanUpdate中设置拖动幅度阈值，仅当拖动超过指定值时触发页面切换：

onPanUpdate: (details) {
  // 阈值可根据需求调整，比如15像素
  if (details.delta.dx > 15) {
    setState(() {
      swipeController.index.value = 0;
    });
  } else if (details.delta.dx < -15) {
    setState(() {
      swipeController.index.value = 1;
    });
  }
},

该方法实现简单，但无法完全避免误触，适合临时解决问题。

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