目录
[一、滑动到指定位置(target position)并且置顶](#一、滑动到指定位置(target position)并且置顶)
[1. RecycleView默认的几个实现方法及缺陷](#1. RecycleView默认的几个实现方法及缺陷)
[2. 优化源码实现置顶方案](#2. 优化源码实现置顶方案)
[1. 其他置顶方案](#1. 其他置顶方案)
[2. 置顶加偏移](#2. 置顶加偏移)
[3. 滚动居中](#3. 滚动居中)
在实际项目里,RecycleView 可以说是我们最常用到的组件,作为绑定并展示LIST数据的组件,经常需要实现平滑滚动到列表里的某个目标ITEM,并且将其置顶在屏幕最上方,而且在特殊情形下,我们需要控制滑动速度,来控制滚动的时长。
一、滑动到指定位置(target position)并且置顶
1. RecycleView默认的几个实现方法及缺陷
((LinearLayoutManager)recycleView.getLayoutManager()).scrollToPositionWithOffset(int position, int offset);
如果你没有滑动过程动画的要求,那上面这行代码将offset的值设置为0,就一步到位地满足需求了。
recycleView.scrollToPosition(int position);
recycleView.smoothScrollToPosition(int position);
以上两个方法遵循的是最少滑动原则,只要target position那项item已经完全可见了,就马上停止滑动;要是target position已经可见了,那根本不会滑动。所以按不同的滑动方向,会出现不同的结果,如果target position在屏幕可视范围的上方,则它默认会将target position置顶;反之,target position在屏幕可视范围的下方,则滚动完成后,target postion会处于屏幕的最下方,无法实现我们的置顶需求。所以缺陷很明显:要么不动,要么无法置顶。
2. 优化源码实现置顶方案
我们看下recycleview提供的方法的源代码,看看是否可以进行改进:
public void smoothScrollToPosition(int position) {
if (mLayoutSuppressed) {
return;
}
if (mLayout == null) {
Log.e(TAG, "Cannot smooth scroll without a LayoutManager set. "
+ "Call setLayoutManager with a non-null argument.");
return;
}
mLayout.smoothScrollToPosition(this, mState, position);
}
由代码可以看出,RecyclerView的滑动方法是调用LayoutManager的smoothScrollToPosition方法:
@Override
public void smoothScrollToPosition(RecyclerView recyclerView, RecyclerView.State state,
int position) {
LinearSmoothScroller linearSmoothScroller =
new LinearSmoothScroller(recyclerView.getContext());
linearSmoothScroller.setTargetPosition(position);
startSmoothScroll(linearSmoothScroller);
}
其中LinearSmoothScroller提供了三个滑动策略:
/**
* Align child view's left or top with parent view's left or top
*
* @see #calculateDtToFit(int, int, int, int, int)
* @see #calculateDxToMakeVisible(android.view.View, int)
* @see #calculateDyToMakeVisible(android.view.View, int)
*/
public static final int SNAP_TO_START = -1;
/**
* Align child view's right or bottom with parent view's right or bottom
*
* @see #calculateDtToFit(int, int, int, int, int)
* @see #calculateDxToMakeVisible(android.view.View, int)
* @see #calculateDyToMakeVisible(android.view.View, int)
*/
public static final int SNAP_TO_END = 1;
/**
* <p>Decides if the child should be snapped from start or end, depending on where it
* currently is in relation to its parent.</p>
* <p>For instance, if the view is virtually on the left of RecyclerView, using
* {@code SNAP_TO_ANY} is the same as using {@code SNAP_TO_START}</p>
*
* @see #calculateDtToFit(int, int, int, int, int)
* @see #calculateDxToMakeVisible(android.view.View, int)
* @see #calculateDyToMakeVisible(android.view.View, int)
*/
public static final int SNAP_TO_ANY = 0;
LinearSmoothScroller确定滑动方案的方法:
/**
* When scrolling towards a child view, this method defines whether we should align the top
* or the bottom edge of the child with the parent RecyclerView.
*
* @return SNAP_TO_START, SNAP_TO_END or SNAP_TO_ANY; depending on the current target vector
* @see #SNAP_TO_START
* @see #SNAP_TO_END
* @see #SNAP_TO_ANY
*/
protected int getVerticalSnapPreference() {
return mTargetVector == null || mTargetVector.y == 0 ? SNAP_TO_ANY :
mTargetVector.y > 0 ? SNAP_TO_END : SNAP_TO_START;
}
重写LinearSmoothScroller的getVerticalSnapPreference方法:
class LinearTopSmoothScroller extends LinearSmoothScroller {
public LinearTopSmoothScroller(Context context) {
super(context);
}
@Override
protected int getVerticalSnapPreference() {
return SNAP_TO_START;
}
}
这里为什么返回 SNAP_TO_START?可以看到LinearSmoothScrollerl的方法calculateDtToFit()根据不同滚动策略获取到需要滚动的距离,SNAP_TO_START是按置顶的方案来计算的。所以我们在getVerticalSnapPreference方法里固定返回SNAP_TO_START就可以实现目的。
public int calculateDtToFit(int viewStart, int viewEnd, int boxStart, int boxEnd, int
snapPreference) {
switch (snapPreference) {
case SNAP_TO_START:
return boxStart - viewStart;
case SNAP_TO_END:
return boxEnd - viewEnd;
case SNAP_TO_ANY:
final int dtStart = boxStart - viewStart;
if (dtStart > 0) {
return dtStart;
}
final int dtEnd = boxEnd - viewEnd;
if (dtEnd < 0) {
return dtEnd;
}
break;
default:
throw new IllegalArgumentException("snap preference should be one of the"
+ " constants defined in SmoothScroller, starting with SNAP_");
}
return 0;
}
调用方式一:
void scrollItemToTop(int position) {
LinearSmoothScroller smoothScroller = new LinearTopSmoothScroller(this);
smoothScroller.setTargetPosition(position);
linearLayoutManager.startSmoothScroll(smoothScroller);
}
调用方式二:
自定义一个类继承自 LinearLayoutManager:
private class TopLayoutManager extends LinearLayoutManager {
public TopLayoutManager(Context context) {
super(context);
}
public TopLayoutManager(Context context, int orientation, boolean reverseLayout) {
super(context, orientation, reverseLayout);
}
@Override
public void smoothScrollToPosition(RecyclerView recyclerView, RecyclerView.State state, int position) {
RecyclerView.SmoothScroller smoothScroller = new LinearTopSmoothScroller(recyclerView.getContext());
smoothScroller.setTargetPosition(position);
startSmoothScroll(smoothScroller);
}
private class LinearTopSmoothScroller extends LinearSmoothScroller {
public LinearTopSmoothScroller(Context context) {
super(context);
}
@Override
protected int getVerticalSnapPreference() {
return SNAP_TO_START;
}
}
}
调用代码:
TopLayoutManager topLayoutManager = new TopLayoutManager(this);
recycleview.setLayoutManager(topLayoutManager);
recycleview.smoothScrollToPosition(position);
二、调整平移滑动速率
同理,可以在LinearSmoothScroller类找到决定滚动速度的方法并修改。
/**
* Calculates the scroll speed.
*
* @param displayMetrics DisplayMetrics to be used for real dimension calculations
* @return The time (in ms) it should take for each pixel. For instance, if returned value is
* 2 ms, it means scrolling 1000 pixels with LinearInterpolation should take 2 seconds.
*/
protected float calculateSpeedPerPixel(DisplayMetrics displayMetrics) {
return MILLISECONDS_PER_INCH / displayMetrics.densityDpi;
}
上面的MILLISECONDS_PER_INCH的值为25F,如果希望更快可以将值改小,这个方法的返回值表示滚动一个像素需要的时间,单位ms,如果返回值为2ms,表示滚动1000个像素需要花费2秒时长。
平滑滚动到target position,【置顶+调速】的调用方式:
RecyclerView.SmoothScroller smoothScroller = new LinearSmoothScroller(this) {
@Override protected int getVerticalSnapPreference() {
return LinearSmoothScroller.SNAP_TO_START;
}
@Override
protected float calculateSpeedPerPixel(DisplayMetrics displayMetrics) {
//默认值是25F(MILLISECONDS_PER_INCH),值越小滑动速度越快,值越大则越慢
return 100F / displayMetrics.densityDpi;
}
};
smoothScroller.setTargetPosition(position);
linearLayoutManager.startSmoothScroll(smoothScroller);
目前还有一个问题,虽然我们可以调整速度,但是这里始终是一个固定的滚动速度,试想如果滚动的距离特别远,仍然需要滚动很长的时间;又或者滚动距离太近,那么滚动动画一瞬间就结束了,缺少了流畅感。
所以我们可以根据需要滚动的远或近来设置不同的滚动速度:
RecyclerView.SmoothScroller smoothScroller = new LinearSmoothScroller(this) {
@Override protected int getVerticalSnapPreference() {
return LinearSmoothScroller.SNAP_TO_START;
}
@Override
protected float calculateSpeedPerPixel(DisplayMetrics displayMetrics) {
// 第一个可见位置
int firstItem = linearLayoutManager.findFirstVisibleItemPosition();
int diff = Math.abs(position - firstItem);
// 将 diff 作分母:滚动距离越远,速度越快。 (100f/diff) 数值如果过小会导致速度过快, 可以再乘一个速度因子变量(speedFactor)来调整
int speedFactor = 5;
float speed = (100f / diff) * speedFactor;
return speed / displayMetrics.densityDpi;
}
};
三、其他方案:置顶、置顶加偏移、居中
1. 其他置顶方案
另外一个实现置顶方案:可以参考这篇文章,Android RecyclerView滚动定位 ,它主要解决的是滚动到屏幕下面ITEM,无法置顶的问题,思路是:先用scrollToPosition,将要置顶的项先移动显示出来,然后计算这一项离顶部的距离,用scrollBy完成最后的100米!
这个方案还有个好处就是,如果target position很远(滑动距离很长),也不会导致屏幕滚动过长的时间。向上向下动态滚动(动画过程)距离都不超过一个屏幕的距离。
2. 置顶加偏移
另外,如果希望置顶后,可以有一定的偏移量(离顶部有一定距离),可以参考这篇文章:
RecyclerView的smooth scroller -- 诸多案例
3. 滚动居中
如果希望target position在滚动结束后,停留在屏幕中间,可以参考下这篇文章:
RecyclerView smoothScroll to position in the center. android