Android中使用CardStackView实现无限滑动的Java方案

我需要在Android Studio中用CardStackView实现无限滑动功能：当用户滑到卡片栈末尾（比如第4张）时，继续滑动能回到第1张，以此循环。官方文档提到可通过更新适配器列表实现，但我的代码无法生效，以下是当前实现：

我的CardStackView初始化代码 #

CardStackView view;
view = findViewById(R.id.card_stack);
manager = new CardStackLayoutManager(this, new 
CardStackListener() {
        @Override
        public void onCardDragging(Direction direction, float ratio) {

        }

        @Override
        public void onCardSwiped(Direction direction) {
            if(direction == Direction.Bottom){
                load_ads();
                view.rewind();
            } else if (direction == Direction.Top) {
                load_ads();
            }
        }

        @Override
        public void onCardRewound() {

        }

        @Override
        public void onCardCanceled() {

        }

        @Override
        public void onCardAppeared(View view, int position) {

        }

        @Override
        public void onCardDisappeared(View view, int position) {

        }
    });
    manager.setStackFrom(StackFrom.Bottom);
    manager.setVisibleCount(3);
    manager.setTranslationInterval(8.0f);
    manager.setScaleInterval(0.95f);
    manager.setSwipeThreshold(0.1f);
    manager.setMaxDegree(00.0f);
    manager.setDirections(Direction.VERTICAL);
    manager.setCanScrollHorizontal(false);
    manager.setSwipeableMethod(SwipeableMethod.Manual);
    manager.setOverlayInterpolator(new LinearInterpolator());

我的NewsAdapter代码 #

public class NewsAdapter extends 
RecyclerView.Adapter<NewsAdapter.Viewholder> {

ArrayList<NewsData> news;
Context context;

public NewsAdapter(ArrayList<NewsData> news, Context context) {
    this.news = news;
    this.context = context;
}

@NonNull
@Override
public Viewholder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
    LayoutInflater inflater = LayoutInflater.from(parent.getContext());
    View view = inflater.inflate(R.layout.news_item_card,parent,false);
    return new Viewholder(view);
}

@Override
public void onBindViewHolder(@NonNull Viewholder holder, int position) {
    holder.setData(news.get(position),context);
}

@Override
public int getItemCount() {
    return news.size();
}

public static class Viewholder extends RecyclerView.ViewHolder{
    ShapeableImageView picture;
    TextView category,title,timestamp,description;
    CardView read_more,category_card,item;
    LinearLayout card;

    public Viewholder(@NonNull View itemView) {
        super(itemView);
        picture = itemView.findViewById(R.id.picture);
        category = itemView.findViewById(R.id.category);
        title = itemView.findViewById(R.id.title);
        timestamp = itemView.findViewById(R.id.timestamp);
        description = itemView.findViewById(R.id.description);
        read_more = itemView.findViewById(R.id.read_more);
        card = itemView.findViewById(R.id.card);
        category_card = itemView.findViewById(R.id.category_card);
        item = itemView.findViewById(R.id.item);
    }

    public void setData(NewsData newsData, Context context) {
        category_card.setBackgroundResource(R.drawable.bg_category);
        read_more.setBackgroundResource(R.drawable.bg_read_more);

        if(Objects.equals(newsData.getCategory(), "World")){
            card.setBackgroundResource(R.drawable.bg_news_item_world);
        }else if(Objects.equals(newsData.getCategory(), "national")){
            card.setBackgroundResource(R.drawable.bg_news_item_national);
        }else if(Objects.equals(newsData.getCategory(), "Business")){
            card.setBackgroundResource(R.drawable.bg_news_item_business);
        }else if(Objects.equals(newsData.getCategory(), "Politics")){
            card.setBackgroundResource(R.drawable.bg_news_item_politics);
        }else if(Objects.equals(newsData.getCategory(), "Entertainment")){
            card.setBackgroundResource(R.drawable.bg_news_item_entertainment);
        }else if(Objects.equals(newsData.getCategory(), "Lifestyle")){
            card.setBackgroundResource(R.drawable.bg_news_item_lifestyle);
        }else if(Objects.equals(newsData.getCategory(), "Technology")){
            card.setBackgroundResource(R.drawable.bg_news_item_technology);
        }

        Glide
                .with(context)
                .load(newsData.getImage())
                .placeholder(R.drawable.image_fill)
                .centerCrop()
                .into(picture);

        category.setText(newsData.getCategory());
        title.setText(newsData.getTitle());
        timestamp.setText(newsData.getTimestamp());
        String des = newsData.getContent().substring(0, 300)+"...";
        description.setText(des);

        read_more.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = new Intent(context, Blog.class);
                intent.putExtra("news_id", newsData.getId());
                context.startActivity(intent);
            }
        });
    }
}

public ArrayList<NewsData> getNews() {
    return news;
}

public void setNews(ArrayList<NewsData> news) {
    this.news = news;
}

实现无限循环滑动有两种可靠方式，根据你的场景选择：

方式一：动态调整列表实现无缝循环 #

这种方式会在滑到最后一张时，把列表的第一个元素移到末尾，视觉上完全无缝，适合卡片数量不多的场景：

1. 修改CardStackListener的onCardDisappeared方法 #

在卡片滑出屏幕时判断是否为最后一张，若为最后一张则调整列表并更新适配器：

@Override
public void onCardDisappeared(View view, int position) {
    NewsAdapter adapter = (NewsAdapter) view.getAdapter();
    if (adapter == null) return;
    
    int totalItems = adapter.getItemCount();
    // 检查是否滑到最后一张
    if (position == totalItems - 1) {
        ArrayList<NewsData> currentList = adapter.getNews();
        // 移除第一个元素并添加到列表末尾
        NewsData firstItem = currentList.remove(0);
        currentList.add(firstItem);
        // 通知适配器数据移动，避免刷新整个列表
        adapter.notifyItemMoved(0, totalItems - 1);
        // 重置布局管理器的顶部位置，避免视觉跳变
        manager.setTopPosition(position);
    }
}

2. 移除原代码中的view.rewind()逻辑 #

原代码中滑向Bottom时调用的view.rewind()会直接回到第一张，和循环需求冲突，建议移除这行代码。

方式二：用取模模拟无限列表 #

这种方式通过让getItemCount返回极大值，并在绑定数据时对真实列表长度取模，适合需要支持快速滑动的场景：

1. 修改NewsAdapter的getItemCount和onBindViewHolder #

@Override
public int getItemCount() {
    // 返回极大值，模拟无限列表
    return news == null ? 0 : Integer.MAX_VALUE;
}

@Override
public void onBindViewHolder(@NonNull Viewholder holder, int position) {
    // 计算真实位置：对真实列表长度取模
    int realPosition = position % news.size();
    holder.setData(news.get(realPosition), context);
}

2. 调整布局管理器的滑动逻辑 #

这种方式不需要修改CardStackListener的回调，滑到任意位置都会自动循环显示内容。

内容的提问来源于stack exchange，提问作者Mihir Jha