RecyclerView SnapHelper 回调

在 Android 开发中，RecyclerView 是非常常用的一个组件，用于展示列表数据。而 SnapHelper 是 RecyclerView 的一个辅助组件，它可以帮我们将 RecyclerView 滑动到某个位置并停止下来，让 RecyclerView 实现类似 ViewPager 的效果。

本文将介绍 RecyclerView SnapHelper 的使用，并详细介绍 SnapHelper 回调的使用。

SnapHelper 的使用

SnapHelper 是 Android RecyclerView 的一个辅助类，主要用于对 RecyclerView 进行定位、对齐等操作。SnapHelper 是 RecyclerView.LayoutManager 的一个子类，可以通过 RecyclerView.setOnFlingListener() 方法绑定到 RecyclerView 上。

实现横向滑动

以下是使用 SnapHelper 实现横向滑动的代码：

SnapHelper snapHelper = new LinearSnapHelper();
snapHelper.attachToRecyclerView(recyclerView);

这里我们创建了一个 LinearSnapHelper 对象，并将其绑定到 RecyclerView 上。这样，RecyclerView 就可以实现横向滑动了。

实现瀑布流布局

以下是使用 SnapHelper 实现瀑布流布局的代码：

SnapHelper snapHelper = new StaggeredGridSnapHelper();
snapHelper.attachToRecyclerView(recyclerView);

这里我们创建了一个 StaggeredGridSnapHelper 对象，并将其绑定到 RecyclerView 上。这样，RecyclerView 就可以实现瀑布流布局了。

自定义 SnapHelper

如果你需要更多定制化的功能，可以使用自定义的 SnapHelper。下面是一个自定义的 SnapHelper 的例子：

public class CustomSnapHelper extends SnapHelper {

    private RecyclerView mRecyclerView;

    @Override
    public void attachToRecyclerView(@Nullable RecyclerView recyclerView)
            throws IllegalStateException {
        super.attachToRecyclerView(recyclerView);
        mRecyclerView = recyclerView;
    }

    @Override
    public int[] calculateDistanceToFinalSnap(@NonNull RecyclerView.LayoutManager layoutManager,
                                              @NonNull View targetView) {
        int[] out = new int[2];
        out[0] = targetView.getLeft() - mRecyclerView.getPaddingLeft();
        out[1] = targetView.getTop() - mRecyclerView.getPaddingTop();
        return out;
    }

    @Nullable
    @Override
    public View findSnapView(RecyclerView.LayoutManager layoutManager) {
        if (layoutManager instanceof LinearLayoutManager) {
            int firstVisibleItemPosition = ((LinearLayoutManager) layoutManager).findFirstVisibleItemPosition();
            if (firstVisibleItemPosition == RecyclerView.NO_POSITION) {
                return null;
            }
            View child = layoutManager.findViewByPosition(firstVisibleItemPosition);
            int distanceToStart = child.getLeft() - mRecyclerView.getPaddingLeft();
            int distanceToEnd = child.getRight() - mRecyclerView.getPaddingRight();
            if (Math.abs(distanceToStart) < Math.abs(distanceToEnd)) {
                return child;
            } else {
                return layoutManager.findViewByPosition(firstVisibleItemPosition + 1);
            }
        } else {
            return null;
        }
    }
}

这里我们创建了一个 CustomSnapHelper 对象，它继承自 SnapHelper。我们重写了 calculateDistanceToFinalSnap() 和 findSnapView() 方法，实现了自定义的 Snap 辅助功能。

SnapHelper 回调

SnapHelper 提供了三种回调：

• onSnapPositionChange(int position)：当 Snap 的位置发生改变时调用
• onSnapViewDetached(View snapView)：当 Snap 的 View 被从 RecyclerView 上移除时调用
• onSnapViewAttached(View snapView)：当 Snap 的 View 被添加到 RecyclerView 上时调用

你可以通过继承普通的 RecyclerView.OnScrollListener 来监听 SnapHelper 的回调，如下所示：

private class CustomScrollListener extends RecyclerView.OnScrollListener {
    @Override
    public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        if(newState == RecyclerView.SCROLL_STATE_IDLE) {
            View snapView = snapHelper.findSnapView(layoutManager);
            if(snapView != null) {
                int position = layoutManager.getPosition(snapView);
                onSnapPositionChange(position);
            }
        }
    }
 
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        View snapView = snapHelper.findSnapView(layoutManager);
        if(snapView != null) {
            if(snapView != mSnapView) {
                onSnapViewDetached(mSnapView);
                mSnapView = snapView;
                onSnapViewAttached(mSnapView);
            }
        }
    }
 
    public void onSnapPositionChange(int position) {
    }
 
    public void onSnapViewDetached(View snapView) {
    }
 
    public void onSnapViewAttached(View snapView) {
    }
}

这里我们继承了 RecyclerView.OnScrollListener，并实现了 onSnapPositionChange()、onSnapViewDetached() 和 onSnapViewAttached() 方法。在 onScrollStateChanged() 和 onScrolled() 中判断 Snap 的位置，如果不同则回调对应的方法。

至此，我们介绍了 RecyclerView SnapHelper 的使用和回调方法。希望本文能帮助你更好地使用 RecyclerView。