Flutter 2.5版本升级后Web端拖拽滚动功能失效问题问询

根因说明 #

Flutter 2.5对Web端默认滚动逻辑做了破坏性变更：默认的ScrollBehavior仅支持鼠标滚轮、触控板滚动手势触发滚动，屏蔽了鼠标拖拽、触屏拖拽的触发能力。这也是单独修改ScrollPhysics不生效的核心原因，滚动行为配置的优先级高于滚动物理特性配置。

实现方案 #

全局配置（推荐，无额外样板代码） #

直接在应用根节点的MaterialApp/CupertinoApp中配置全局滚动行为，一次性适配所有滚动组件，不需要修改任何原有业务代码。
首先自定义全局滚动行为类：

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

class RestoreScrollBehavior extends MaterialScrollBehavior {
  // 开放所有可触发滚动的输入设备类型
  @override
  Set<PointerDeviceKind> get dragDevices => {
    PointerDeviceKind.touch,
    PointerDeviceKind.mouse,
    PointerDeviceKind.stylus,
    PointerDeviceKind.invertedStylus,
    PointerDeviceKind.trackpad,
  };
}

然后在根节点应用该配置：

MaterialApp(
  title: '你的应用名',
  scrollBehavior: RestoreScrollBehavior(),
  home: const YourHomePage(),
)

配置完成后，所有SingleChildScrollView、TabBarView、ListView等自带滚动能力的组件都会自动恢复2.2版本的拖拽滚动效果，横竖双向滚动均支持。

局部组件适配 #

如果仅需要部分组件支持拖拽滚动，不需要全局修改，给目标组件外层包裹ScrollConfiguration即可，样板代码量远低于自定义GestureDetector方案：

ScrollConfiguration(
  behavior: RestoreScrollBehavior(),
  child: SingleChildScrollView(
    // 原有组件逻辑无需修改
  ),
)

注意事项 #

• 不需要额外修改原有滚动组件的physics属性，默认物理特性即可满足需求
• 该配置兼容Web、桌面端、移动端多平台滚动逻辑

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