如何实现横向RecyclerView循环滚动：从最后项滑至第一项

嘿，我刚好搞定过类似的需求——横向RecyclerView只有4个条目，想要滑到末尾再往左滑直接跳第一个，滑到第一个往右滑跳最后一个对吧？给你两个实用的方案，都是我实际项目里用过的：

方案一：Adapter“假无限”循环（推荐，适合条目少的场景） #

这个方法最简单，核心就是让Adapter返回一个极大的条目数，然后通过取模来复用真实数据，再把初始位置设到中间，让用户感觉是无限循环的。

代码示例： #

首先是你的Adapter：

public class LoopRecyclerAdapter extends RecyclerView.Adapter<LoopRecyclerAdapter.ItemViewHolder> {
    private List<String> mRealData;
    private int mRealItemCount;

    public LoopRecyclerAdapter(List<String> data) {
        mRealData = data;
        mRealItemCount = data == null ? 0 : data.size();
    }

    @Override
    public int getItemCount() {
        // 返回一个超大数，模拟无限循环，避免用户滑到尽头
        return mRealItemCount == 0 ? 0 : Integer.MAX_VALUE;
    }

    @Override
    public void onBindViewHolder(@NonNull ItemViewHolder holder, int position) {
        // 用取模得到真实的条目索引，循环复用数据
        int realPosition = position % mRealItemCount;
        holder.itemTv.setText(mRealData.get(realPosition));
    }

    // ViewHolder 定义
    static class ItemViewHolder extends RecyclerView.ViewHolder {
        TextView itemTv;
        public ItemViewHolder(@NonNull View itemView) {
            super(itemView);
            itemTv = itemView.findViewById(R.id.item_text);
        }
    }
}

然后是RecyclerView的初始化：

RecyclerView recyclerView = findViewById(R.id.horizontal_recycler);
// 横向布局管理器
LinearLayoutManager layoutManager = new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false);
recyclerView.setLayoutManager(layoutManager);

List<String> dataList = Arrays.asList("条目1", "条目2", "条目3", "条目4");
LoopRecyclerAdapter adapter = new LoopRecyclerAdapter(dataList);
recyclerView.setAdapter(adapter);

// 关键！把初始位置设到中间，这样左右都能无限滑
int middlePosition = Integer.MAX_VALUE / 2 - (Integer.MAX_VALUE / 2) % adapter.mRealItemCount;
layoutManager.scrollToPosition(middlePosition);

这个方案的好处是几乎不用动LayoutManager，代码量小，对于只有4个条目的场景完全够用，唯一要注意的是：如果需要获取当前真实位置，记得对position取模。

方案二：自定义LayoutManager实现“真”循环 #

如果你想要更“原生”的循环效果（比如position是真实的），可以自定义LinearLayoutManager，重写滚动逻辑，处理边界时把首尾条目互换位置。

简化版代码示例： #

public class LoopHorizontalLayoutManager extends LinearLayoutManager {

    public LoopHorizontalLayoutManager(Context context) {
        super(context, LinearLayoutManager.HORIZONTAL, false);
    }

    @Override
    public int scrollHorizontallyBy(int dx, RecyclerView.Recycler recycler, RecyclerView.State state) {
        int scrollOffset = super.scrollHorizontallyBy(dx, recycler, state);
        
        // 处理向右滚动（用户向左滑）到最后一个条目时的循环
        if (dx > 0) {
            View lastChild = getChildAt(getChildCount() - 1);
            if (lastChild != null && getPosition(lastChild) == getItemCount() - 1) {
                // 把第一个条目移到最后面
                View firstChild = getChildAt(0);
                detachView(firstChild);
                recycler.recycleView(firstChild);
                attachView(firstChild);
                // 重新布局第一个条目到最后一个的右边
                layoutDecorated(firstChild, 
                    lastChild.getRight(), lastChild.getTop(), 
                    lastChild.getRight() + firstChild.getWidth(), lastChild.getBottom());
                return dx;
            }
        } 
        // 处理向左滚动（用户向右滑）到第一个条目时的循环
        else {
            View firstChild = getChildAt(0);
            if (firstChild != null && getPosition(firstChild) == 0) {
                // 把最后一个条目移到最前面
                View lastChild = getChildAt(getChildCount() - 1);
                detachView(lastChild);
                recycler.recycleView(lastChild);
                attachView(lastChild, 0);
                // 重新布局最后一个条目到第一个的左边
                layoutDecorated(lastChild, 
                    firstChild.getLeft() - lastChild.getWidth(), firstChild.getTop(), 
                    firstChild.getLeft(), firstChild.getBottom());
                return dx;
            }
        }
        return scrollOffset;
    }

    @Override
    public boolean canScrollHorizontally() {
        return true;
    }
}

使用的时候直接把LayoutManager换成这个自定义的就行，Adapter不用改，保持真实的4个条目数。不过这个方案要注意处理快速滚动、条目大小不一致等边界情况，相对复杂一点。

总结 #

因为你的条目只有4个，方案一绝对是最优解，代码简单，运行稳定，用户完全感知不到“假循环”的存在。如果有特殊需求再考虑方案二。

内容的提问来源于stack exchange，提问作者J DEO