Flutter PageView如何禁止左侧滑动、仅允许向右翻页？

底层实现逻辑基础 #

Flutter 的滚动组件职责是完全分离的：

• PageController 仅负责管理当前滚动偏移、触发动画跳页，不参与用户手势的滑动边界判断，因此本身没有提供控制滑动方向的相关API
• 所有用户手势的响应规则、滚动边界拦截、阻尼效果计算，全部由绑定的 ScrollPhysics 类统一处理。要实现自定义滑动方向限制，完全不需要修改PageController的逻辑，只需要重写ScrollPhysics的边界拦截规则即可。

我们需要达成的拦截效果是：

• 允许用户做出正向翻页的动作（翻到索引更大的右侧页面），滑动跟手度和原生PageView完全一致
• 完全拦截用户想要回退到上一页的滑动动作，不会产生任何无效滚动位移

自定义ScrollPhysics完整实现 #

class ForwardOnlyPagePhysics extends ScrollPhysics {
  const ForwardOnlyPagePhysics({super.parent});

  @override
  ForwardOnlyPagePhysics applyTo(ScrollPhysics? ancestor) {
    return ForwardOnlyPagePhysics(parent: buildParent(ancestor));
  }

  @override
  double applyBoundaryConditions(ScrollMetrics position, double value) {
    // 先保留原生物理规则的边界判断
    final baseRule = super.applyBoundaryConditions(position, value);
    if (baseRule != 0) return baseRule;

    // 拦截回退类滑动：当目标滚动偏移小于当前实际偏移时，说明用户手势是想要回到上一页
    // 该方法返回的数值代表需要从目标偏移中扣除的无效位移，返回非0值即可完全钳制滑动
    if (value < position.pixels) {
      return value - position.pixels;
    }

    // 正向滑动场景返回0，代表完全允许正常滚动
    return 0;
  }
}

代码逻辑逐行解析 #

1. 类继承部分：所有自定义ScrollPhysics都需要重写applyTo方法，完成物理规则的实例传递，避免在嵌套滚动场景下出现规则丢失、滑动冲突的问题，这是Flutter滚动框架的强制规范。
2. 核心拦截入口：applyBoundaryConditions是ScrollPhysics中负责拦截无效滚动的核心方法，方法的返回值规则为：
   • 返回0时，代表当前的滚动目标偏移完全合法，组件会正常响应该滑动动作
   • 返回非0值时，代表需要从目标偏移中扣除对应差值的无效位移，最终实际的滚动位置 = 目标值 - 返回的差值
3. 保留原生规则：首先调用父类的边界判断方法，不会破坏PageView原有的滚动效果（比如到达最后一页时的弹性拉伸、快速滑动的fling效果），避免和系统原生物理行为冲突。
4. 单方向拦截逻辑：判断value < position.pixels的场景——此时value是手势计算出的目标滚动偏移，position.pixels是组件当前实际的滚动偏移，当目标值小于当前值时，对应的就是用户在屏幕上向右划动、想要回退到左侧上一页的手势，这时候直接返回偏移差值，把所有回退的无效位移全部扣除，手势不会产生任何滚动效果，自然就实现了禁止回退滑动的需求。
5. 正向放行：当目标偏移大于当前实际偏移时（对应用户在屏幕上向左划动、翻到右侧下一页的手势），返回0完全放行，和原生PageView的滑动体验没有任何区别。

实际接入方式 #

直接把自定义的物理规则绑定到PageView的physics参数上即可，不需要修改PageController的任何配置：

PageView(
  controller: pageController,
  physics: const ForwardOnlyPagePhysics(),
  children: const [
    // 你的页面列表
  ],
)

注意事项 #

• 首先明确方向对应关系，避免逻辑混淆：我们定义的向右翻页，指翻页目标是索引更大、位于屏幕右侧的下一页，对应用户手指在屏幕上向左划动的手势；禁止的向左翻页动作，指回到索引更小、位于屏幕左侧的上一页，对应用户手指在屏幕上向右划动的手势，完全匹配需求描述的交互规则。
• 该实现仅拦截用户的手势滑动操作，不会影响代码主动触发的跳页动画：即使手动调用pageController.previousPage()方法，依然可以正常触发回退到上一页的动画。如果需要完全禁止代码层面的回退操作，只需要在调用previousPage的位置增加逻辑判断即可。
• 该物理规则是通用的，不光适用于PageView，任何横向滚动的ListView、CustomScrollView想要实现禁止回退滑动的效果，都可以直接复用这段代码。

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