彻底解决滑动冲突！RecyclerView嵌套Banner 2.0全攻略-优快云博客

彻底解决滑动冲突！RecyclerView嵌套Banner 2.0全攻略

【免费下载链接】banner 🔥🔥🔥Banner 2.0 来了！Android广告图片轮播控件，内部基于ViewPager2实现，Indicator和UI都可以自定义。项目地址: https://gitcode.com/gh_mirrors/ba/banner

你是否还在为RecyclerView嵌套Banner时的滑动冲突烦恼？手指上滑想浏览列表，Banner却固执地横向滚动？本文将带你使用ParentRecyclerView组件，三步实现流畅的嵌套滑动体验，同时掌握Banner 2.0的高级用法。

冲突根源：触摸事件的"抢占地盘"

Android中的View事件传递机制如同一场"权利的游戏"，当RecyclerView（纵向滑动）遇上Banner（横向滑动），两者都想获取触摸事件的控制权。典型表现为：

横向滑动Banner时列表跟着上下抖动
试图上下滚动时触发Banner切换
滑动边界时出现"粘滞感"

项目中提供了完整的冲突解决方案，核心实现位于app/src/main/java/com/test/banner/util/ParentRecyclerView.java。

解决方案：ParentRecyclerView的"智能分流"

核心原理：事件方向识别

ParentRecyclerView通过重写dispatchTouchEvent方法，根据滑动轨迹判断用户意图：

// 关键代码：app/src/main/java/com/test/banner/util/ParentRecyclerView.java#L26-L42
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    switch (ev.getAction()) {
        case MotionEvent.ACTION_DOWN:
            mStartX = ev.getX();
            mStartY = ev.getY();
            break;
        case MotionEvent.ACTION_MOVE:
            float endX = ev.getX();
            float endY = ev.getY();
            float distanceX = Math.abs(endX - mStartX);
            float distanceY = Math.abs(endY - mStartY);
            // 横向滑动距离>纵向时，禁止父容器拦截事件
            getParent().requestDisallowInterceptTouchEvent(!(distanceX > 4 && distanceX > distanceY));
            break;
    }
    return super.dispatchTouchEvent(ev);
}

这段代码实现了"滑动方向识别"的核心逻辑：当横向滑动距离超过纵向且达到4像素阈值时，让Banner获得事件处理权；否则交给RecyclerView处理纵向滚动。

布局文件改造

将普通RecyclerView替换为自定义的ParentRecyclerView，在布局文件中这样声明：

<!-- 示例布局：app/src/main/res/layout/activity_recyclerview_banner.xml -->
<com.test.banner.util.ParentRecyclerView
    android:id="@+id/net_rv"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

对应的Activity实现可参考app/src/main/java/com/test/banner/ui/RecyclerViewBannerActivity.java，关键代码如下：

// 设置布局管理器和适配器
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setAdapter(new MyRecyclerViewAdapter(this));

完整实现：三步集成指南

第一步：引入ParentRecyclerView

将ParentRecyclerView添加到项目中，文件路径：app/src/main/java/com/test/banner/util/ParentRecyclerView.java

第二步：创建混合布局适配器

使用RecyclerView的多类型布局功能，在适配器中同时处理普通列表项和Banner项。核心代码位于app/src/main/java/com/test/banner/adapter/MyRecyclerViewAdapter.java：

// 重写 getItemViewType 方法区分布局类型
@Override
public int getItemViewType(int position) {
    return (position % 5 == 0) ? R.layout.banner : R.layout.item;
}

// 在 onCreateViewHolder 中创建不同类型的ViewHolder
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    if (viewType == R.layout.item) {
        return new MyViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.item, parent, false));
    } else {
        return new MyBannerViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.banner, parent, false));
    }
}

第三步：配置Banner属性

在BannerViewHolder中配置轮播参数，包括图片适配器、指示器样式等：

// 绑定Banner数据和样式
Banner banner = ((MyBannerViewHolder) holder).banner;
banner.setAdapter(new ImageNetAdapter(DataBean.getTestData3()));
banner.setBannerRound(BannerUtils.dp2px(5));
banner.setIndicator(new RoundLinesIndicator(context));
banner.setIndicatorSelectedWidth((int) BannerUtils.dp2px(15));

高级优化：流畅体验的四个技巧

1. 内存管理：页面可见性控制

Banner作为耗资源组件，应当在不可见时停止轮播。项目中已注释掉的代码段展示了最佳实践：

// 建议取消注释启用此功能
@Override
public void onViewDetachedFromWindow(@NonNull RecyclerView.ViewHolder holder) {
    super.onViewDetachedFromWindow(holder);
    if (holder instanceof MyBannerViewHolder) {
        ((MyBannerViewHolder) holder).banner.stop();
    }
}

@Override
public void onViewAttachedToWindow(RecyclerView.ViewHolder holder) {
    super.onViewAttachedToWindow(holder);
    if (holder instanceof MyBannerViewHolder) {
        ((MyBannerViewHolder) holder).banner.start();
    }
}