当前位置：首页 > news >正文

在Flutter中实现排行榜滑动阻尼效果

news 2024/10/25 19:44:38

在Flutter中实现排行榜滑动阻尼效果

在开发排行榜模块时，UI提出了一个需求，希望滑动时能够增加阻尼效果，每次只能滑动一个Item的宽度，若未达到边界则回弹。这种效果类似于 PageView 的滑动体验，能够更好地限制滑动范围，并提供更为流畅的体验。

预览效果

效果大致如下图所示：

效果预览

实现方法

针对这种需求，我们可以通过自定义 ScrollPhysics 来实现。下面是具体实现代码。

自定义 `ScrollPhysics`

首先，我们创建一个名为 CustomScrollPhysics 的类，继承自 ScrollPhysics。在该类中，我们通过对滑动进行控制，来实现指定宽度的滑动，并在未达到滑动目标时回弹。

import 'package:flutter/material.dart';// 自定义滑动吸附布局
class CustomScrollPhysics extends ScrollPhysics {final double itemDimension;const CustomScrollPhysics({required this.itemDimension, super.parent});@overrideCustomScrollPhysics applyTo(ScrollPhysics? ancestor) {return CustomScrollPhysics(itemDimension: itemDimension, parent: buildParent(ancestor));}double _getPage(ScrollMetrics position) {return position.pixels / itemDimension;}double _getPixels(double page) {return page * itemDimension;}double _getTargetPixels(ScrollMetrics position, Tolerance tolerance, double velocity) {double page = _getPage(position);if (velocity < -tolerance.velocity) {page -= 0.5;} else if (velocity > tolerance.velocity) {page += 0.5;}return _getPixels(page.roundToDouble());}@overrideSimulation? createBallisticSimulation(ScrollMetrics position, double velocity) {// 如果超出范围且不返回，使用父级的物理模拟以返回到边界if ((velocity <= 0.0 && position.pixels <= position.minScrollExtent) ||(velocity >= 0.0 && position.pixels >= position.maxScrollExtent)) {return super.createBallisticSimulation(position, velocity);}final Tolerance tolerance = this.tolerance;final double target = _getTargetPixels(position, tolerance, velocity);if (target != position.pixels) {return ScrollSpringSimulation(spring, position.pixels, target, velocity, tolerance: tolerance);}return null;}@overridebool get allowImplicitScrolling => false;
}

参数解释

•	itemDimension：定义每次滑动的最大距离，这里可以设置为单个Item的宽度。
•	_getTargetPixels：根据滑动的速度和方向，计算滑动的最终位置，若未达到边界则回弹。
•	createBallisticSimulation：负责创建弹簧效果的模拟，确保每次滑动达到指定的距离。

使用 CustomScrollPhysics

将 CustomScrollPhysics 应用到需要此效果的 ListView 中即可。以下是 ListView 的代码示例：

ListView.separated(padding: EdgeInsets.only(left: 12.w, right: lastItemRightPadding),scrollDirection: Axis.horizontal,physics: CustomScrollPhysics(itemDimension: columnItemWidth + 20.w),// 其他参数...
);