默认多点触控滚动
概述
#ScrollBehavior 现在允许或禁止屏幕上指针数量影响滚动速度。默认情况下，ScrollBehavior.multitouchDragStrategy 会阻止多个指针同时与可滚动组件交互以影响滚动速度。
背景
#在此更改之前，拖动 Scrollable widget 的每个指针都会增加滚动速度。这不符合平台在与 Flutter 应用程序交互时的预期。
现在，继承的 ScrollBehavior 根据 ScrollBehavior.multitouchDragStrategy 指定，管理多个指针如何影响滚动 widget。此枚举 MultitouchDragStrategy 也可以配置为之前的行为。
变更说明
#此更改修复了通过使用多个手指拖动来增加滚动速度的意外能力。
如果在您的应用程序中依赖于之前的行为，可以通过几种方式来控制和配置此功能。
扩展
ScrollBehavior、MaterialScrollBehavior或CupertinoScrollBehavior来修改默认行为，重写ScrollBehavior.multitouchDragStrategy。- 有了您自己的
ScrollBehavior，您可以通过设置MaterialApp.scrollBehavior或CupertinoApp.scrollBehavior将其应用于整个应用程序。 - 或者，如果您只想将其应用于特定组件，请在相关组件上方添加一个
ScrollConfiguration，并使用您的自定义ScrollBehavior。
- 有了您自己的
您的可滚动 widget 然后继承并反映此行为。
- 另一种更改默认行为的选项是复制现有的
ScrollBehavior，并设置不同的multitouchDragStrategy，而不是创建自己的ScrollBehavior。- 在您的组件树中创建一个
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