默认多点触控滚动
概述
#ScrollBehavior 现在允许或禁止滚动速度受屏幕上指针数量的影响。默认情况下，ScrollBehavior.multitouchDragStrategy 会阻止多个指针同时与可滚动区域交互时影响滚动速度。
背景
#在此更改之前，每当有一个指针拖动 Scrollable 组件时，滚动速度都会增加。这与用户在使用 Flutter 应用程序时的平台预期不符。
现在，继承的 ScrollBehavior 会根据 ScrollBehavior.multitouchDragStrategy 的规定，管理多个指针如何影响滚动组件。这个枚举类型 MultitouchDragStrategy 也可以配置为与以前的行为一致。
变更说明
#此更改修复了通过多指拖动来提高滚动速度的意外行为。
如果您在应用程序中依赖了之前的行为，有几种方法可以控制和配置此功能。
扩展
ScrollBehavior、MaterialScrollBehavior或CupertinoScrollBehavior来修改默认行为，并覆盖ScrollBehavior.multitouchDragStrategy。- 有了您自己的
ScrollBehavior，您可以通过设置MaterialApp.scrollBehavior或CupertinoApp.scrollBehavior将其应用于整个应用程序。 - 或者，如果您只想将其应用于特定组件，请在相关组件上方添加一个
ScrollConfiguration，并使用您的自定义ScrollBehavior。
- 有了您自己的
然后，您的可滚动组件将继承并反映此行为。
- 除了创建自己的
ScrollBehavior之外，改变默认行为的另一个选择是复制现有的ScrollBehavior，并设置不同的multitouchDragStrategy。- 在您的组件树中创建一个
ScrollConfiguration，并使用copyWith提供当前上下文中现有ScrollBehavior的修改副本。
- 在您的组件树中创建一个
为了适应新的配置，DragGestureRecognizer 也已更新，以在其他拖动上下文中支持 MultitouchDragStrategy。
迁移指南
#为应用程序设置自定义 ScrollBehavior
#迁移前的代码
dart
MaterialApp(
// ...
);迁移后的代码
dart
class MyCustomScrollBehavior extends MaterialScrollBehavior {
// Override behavior methods and getters like multitouchDragStrategy
@override
MultitouchDragStrategy getMultitouchDragStrategy(BuildContext context) => MultitouchDragStrategy.sumAllPointers;
}
// Set ScrollBehavior for an entire application.
MaterialApp(
scrollBehavior: MyCustomScrollBehavior(),
// ...
);为特定组件设置自定义 ScrollBehavior
#迁移前的代码
dart
final ScrollController controller = ScrollController();
ListView.builder(
controller: controller,
itemBuilder: (BuildContext context, int index) {
return Text('Item $index');
},
);迁移后的代码
dart
class MyCustomScrollBehavior extends MaterialScrollBehavior {
// Override behavior methods and getters like multitouchDragStrategy
@override
MultitouchDragStrategy getMultitouchDragStrategy(BuildContext context) => MultitouchDragStrategy.sumAllPointers;
}
// ScrollBehavior can be set for a specific widget.
final ScrollController controller = ScrollController();
ScrollConfiguration(
behavior: MyCustomScrollBehavior(),
child: ListView.builder(
controller: controller,
itemBuilder: (BuildContext context, int index) {
return Text('Item $index');
},
),
);复制并修改现有 ScrollBehavior
#迁移前的代码
dart
final ScrollController controller = ScrollController();
ListView.builder(
controller: controller,
itemBuilder: (BuildContext context, int index) {
return Text('Item $index');
},
);迁移后的代码
dart
// ScrollBehavior can be copied and adjusted.
final ScrollController controller = ScrollController();
ScrollConfiguration(
behavior: ScrollConfiguration.of(context).copyWith(
multitouchDragStrategy: MultitouchDragStrategy.sumAllPointers,
),
child: ListView.builder(
controller: controller,
itemBuilder: (BuildContext context, int index) {
return Text('Item $index');
},
),
);时间线
#发布版本：3.18.0-4.0.pre
稳定版本：3.19.0
参考资料
#API 文档
ScrollConfigurationScrollBehaviorMaterialScrollBehaviorCupertinoScrollBehaviorMultitouchDragStrategyDragGestureRecognizer
相关议题
相关 PR