Flutter中ScrollController对应Swift/UIKit的scrollViewWillEndDragging替代方案

Flutter中没有直接对应UIKit里scrollViewWillEndDragging(_:withVelocity:targetContentOffset:)的API，但可以通过以下两种方式实现拦截滚动目标偏移、禁止滚动到特定区域的需求：

方式一：自定义ScrollPhysics（推荐，无视觉跳动） #

通过自定义ScrollPhysics子类，重写弹道模拟逻辑，在滚动进入惯性阶段前修正目标位置，这是最接近UIKit原生API效果的实现方式：

import 'package:flutter/material.dart';
import 'package:flutter/physics.dart';

class RestrictedScrollPhysics extends ClampingScrollPhysics {
  final double restrictedMinY;
  final double restrictedMaxY;
  final double snapToPosition;

  RestrictedScrollPhysics({
    required this.restrictedMinY,
    required this.restrictedMaxY,
    required this.snapToPosition,
    ScrollPhysics? parent,
  }) : super(parent: parent);

  @override
  RestrictedScrollPhysics applyTo(ScrollPhysics? ancestor) {
    return RestrictedScrollPhysics(
      restrictedMinY: restrictedMinY,
      restrictedMaxY: restrictedMaxY,
      snapToPosition: snapToPosition,
      parent: buildParent(ancestor),
    );
  }

  @override
  Simulation? createBallisticSimulation(ScrollMetrics position, double velocity) {
    final defaultSimulation = super.createBallisticSimulation(position, velocity);
    if (defaultSimulation == null) return null;

    // 计算默认模拟的最终停止位置
    final targetPosition = defaultSimulation.x(double.infinity);

    // 如果目标位置落在禁止区域内，替换为指定的修正位置
    if (targetPosition > restrictedMinY && targetPosition < restrictedMaxY) {
      return ScrollSpringSimulation(
        spring,
        position.pixels,
        snapToPosition,
        velocity,
        tolerance: tolerance,
      );
    }

    return defaultSimulation;
  }
}

使用时，将自定义Physics传入滚动组件：

ListView(
  physics: RestrictedScrollPhysics(
    restrictedMinY: 100,
    restrictedMaxY: 150,
    snapToPosition: 100,
  ),
  children: [
    // 你的列表内容
  ],
)

方式二：监听ScrollEndNotification（简单但有轻微跳动） #

通过NotificationListener监听滚动结束事件，近似计算目标位置后，通过ScrollController调整到指定位置：

final ScrollController _scrollController = ScrollController();

// ...

NotificationListener<ScrollEndNotification>(
  onNotification: (notification) {
    final metrics = notification.metrics;
    // 近似计算惯性滚动的目标位置
    final targetY = metrics.pixels + metrics.velocity.y * 0.1;
    
    if (targetY > 100 && targetY < 150) {
      _scrollController.animateTo(
        100,
        duration: const Duration(milliseconds: 200),
        curve: Curves.easeOut,
      );
    }
    return false;
  },
  child: ListView(
    controller: _scrollController,
    children: [
      // 你的列表内容
    ],
  ),
)

两种方式对比 #

• 自定义ScrollPhysics：完全融入Flutter的滚动物理系统，调整过程无视觉跳动，体验和UIKit原生一致，推荐用于对滚动流畅度要求高的场景。
• 监听ScrollEndNotification：实现简单，但属于事后调整，可能出现轻微的位置跳动，适合快速原型或对流畅度要求不高的场景。

内容的提问来源于stack exchange，提问作者Daisy the cat