Android ViewPager2+TabLayout配合单个RecyclerView适配问题求助

核心问题解释 #

ViewPager2 本质基于 RecyclerView 实现，必须绑定适配器才能正常工作——哪怕你不需要它展示任何内容，只是要利用它和 TabLayout 的滑动联动功能。你遇到的错误就是因为没给 ViewPager2 设置适配器就关联了 TabLayoutMediator。

步骤1：创建极简的空适配器 #

我们只需要一个能提供10个空页面的适配器，不需要任何实际内容：

Kotlin 代码 #

class EmptyPagerAdapter : RecyclerView.Adapter<EmptyPagerAdapter.EmptyViewHolder>() {
    // 对应10个Tab的页面数量
    override fun getItemCount() = 10

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): EmptyViewHolder {
        // 创建一个空View，大小匹配父布局
        val emptyView = View(parent.context)
        emptyView.layoutParams = ViewGroup.LayoutParams(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT
        )
        return EmptyViewHolder(emptyView)
    }

    override fun onBindViewHolder(holder: EmptyViewHolder, position: Int) {
        // 空实现，无需展示内容
    }

    class EmptyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView)
}

Java 代码 #

public class EmptyPagerAdapter extends RecyclerView.Adapter<EmptyPagerAdapter.EmptyViewHolder> {
    @Override
    public int getItemCount() {
        return 10;
    }

    @NonNull
    @Override
    public EmptyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View emptyView = new View(parent.getContext());
        emptyView.setLayoutParams(new ViewGroup.LayoutParams(
                ViewGroup.LayoutParams.MATCH_PARENT,
                ViewGroup.LayoutParams.MATCH_PARENT
        ));
        return new EmptyViewHolder(emptyView);
    }

    @Override
    public void onBindViewHolder(@NonNull EmptyViewHolder holder, int position) {
        // 空实现
    }

    public static class EmptyViewHolder extends RecyclerView.ViewHolder {
        public EmptyViewHolder(@NonNull View itemView) {
            super(itemView);
        }
    }
}

步骤2：绑定适配器并关联TabLayout #

在Activity/Fragment中，先给ViewPager2设置适配器，再用TabLayoutMediator关联：

Kotlin 代码 #

val viewPager2 = findViewById<ViewPager2>(R.id.viewPager2)
val tabLayout = findViewById<TabLayout>(R.id.tabLayout)

// 设置空适配器
viewPager2.adapter = EmptyPagerAdapter()

// 关联TabLayout与ViewPager2，同时设置Tab文本
TabLayoutMediator(tabLayout, viewPager2) { tab, position ->
    tab.text = "Tab ${position + 1}"
}.attach()

Java 代码 #

ViewPager2 viewPager2 = findViewById(R.id.viewPager2);
TabLayout tabLayout = findViewById(R.id.tabLayout);

viewPager2.setAdapter(new EmptyPagerAdapter());

new TabLayoutMediator(tabLayout, viewPager2, (tab, position) -> {
    tab.setText("Tab " + (position + 1));
}).attach();

步骤3：监听Tab切换更新RecyclerView #

滑动Tab或ViewPager2会自动联动，接下来监听选中位置，更新下方RecyclerView的内容：

Kotlin 监听实现 #

// 监听Tab选中事件
tabLayout.addOnTabSelectedListener(object : TabLayout.OnTabSelectedListener {
    override fun onTabSelected(tab: TabLayout.Tab?) {
        tab?.position?.let { position ->
            updateRecyclerViewData(position)
        }
    }

    override fun onTabUnselected(tab: TabLayout.Tab?) {}
    override fun onTabReselected(tab: TabLayout.Tab?) {}
})

// 或者监听ViewPager2页面切换事件
viewPager2.registerOnPageChangeCallback(object : ViewPager2.OnPageChangeCallback() {
    override fun onPageSelected(position: Int) {
        super.onPageSelected(position)
        updateRecyclerViewData(position)
    }
})

// 自定义RecyclerView数据更新方法
private fun updateRecyclerViewData(position: Int) {
    val newData = getTabSpecificData(position)
    yourRecyclerViewAdapter.submitList(newData)
}

Java 监听实现 #

tabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
    @Override
    public void onTabSelected(TabLayout.Tab tab) {
        int position = tab.getPosition();
        updateRecyclerViewData(position);
    }

    @Override
    public void onTabUnselected(TabLayout.Tab tab) {}

    @Override
    public void onTabReselected(TabLayout.Tab tab) {}
});

// 或者监听ViewPager2页面切换
viewPager2.registerOnPageChangeCallback(new ViewPager2.OnPageChangeCallback() {
    @Override
    public void onPageSelected(int position) {
        super.onPageSelected(position);
        updateRecyclerViewData(position);
    }
});

// 自定义数据更新方法
private void updateRecyclerViewData(int position) {
    List<YourDataType> newData = getTabSpecificData(position);
    yourRecyclerViewAdapter.submitList(newData);
}

关键说明 #

• 这个空适配器仅满足ViewPager2的运行要求，不会显示任何内容，完全不影响下方的RecyclerView
• 滑动联动的核心是TabLayoutMediator将Tab位置与ViewPager2页面位置绑定，必须保证适配器的getItemCount()和Tab数量一致（此处为10）

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