Flutter如何限制BouncingScrollPhysics的回弹滚动偏移量？

（为保证表述清晰，已对问题进行编辑整理）

需要限制BouncingScrollPhysics生成的回弹空白区域高度。默认逻辑下该空白区域（滚动越界偏移量）大小由滑动速度决定，需要找到给偏移量设置上限的实现方法。

BouncingScrollPhysics本身没有提供直接配置最大回弹偏移的参数，通过自定义继承该类、重写边界条件计算方法即可实现偏移上限限制，不会破坏原有回弹动画和交互逻辑。

• 首先自定义滚动物理类，支持配置最大回弹高度：

class ClampedBouncingScrollPhysics extends BouncingScrollPhysics {
  const ClampedBouncingScrollPhysics({
    super.parent,
    // 自定义最大回弹偏移高度，单位为逻辑像素
    this.maxOverscrollExtent = 100,
  });

  final double maxOverscrollExtent;

  @override
  ClampedBouncingScrollPhysics applyTo(ScrollPhysics? ancestor) {
    return ClampedBouncingScrollPhysics(
      parent: buildParent(ancestor),
      maxOverscrollExtent: maxOverscrollExtent,
    );
  }

  @override
  double applyBoundaryConditions(ScrollMetrics position, double value) {
    final defaultResult = super.applyBoundaryConditions(position, value);
    if (defaultResult == 0.0) return 0.0;

    if (value < position.minScrollExtent) {
      // 顶部越界场景
      final currentOverscroll = position.minScrollExtent - value;
      if (currentOverscroll > maxOverscrollExtent) {
        return value - (position.minScrollExtent - maxOverscrollExtent);
      }
    } else if (value > position.maxScrollExtent) {
      // 底部越界场景
      final currentOverscroll = value - position.maxScrollExtent;
      if (currentOverscroll > maxOverscrollExtent) {
        return value - (position.maxScrollExtent + maxOverscrollExtent);
      }
    }
    return defaultResult;
  }
}

• 在滚动组件中引入使用，传入你需要的最大回弹高度即可：

// ListView使用示例
ListView.builder(
  physics: const ClampedBouncingScrollPhysics(maxOverscrollExtent: 80),
  itemCount: 20,
  itemBuilder: (context, index) => ListTile(title: Text('列表项 $index')),
)

// CustomScrollView使用示例
CustomScrollView(
  physics: const ClampedBouncingScrollPhysics(maxOverscrollExtent: 120),
  slivers: [
    // 你的sliver组件
  ],
)

• 注意事项：
  • maxOverscrollExtent可根据业务需求自由调整，数值越大允许的回弹空白区域越高
  • 该实现兼容原有BouncingScrollPhysics的所有交互特性，包括松手后的回弹动画、手势阻尼效果，仅对最大越界距离做了硬截断，高速滑动时也不会超出设定上限
  • 如果需要和其他滚动物理类组合使用，正常通过parent参数传入即可，无兼容问题

内容的提问来源于stack exchange，提问作者Ng Lok Chun