如何禁用ViewPager2与TabLayout联动时的切换动画？

云原生阿岚

2026-5-6

解决TabLayoutMediator关联ViewPager2时禁用Tab点击平滑滚动的问题

这个问题确实挺棘手的——毕竟TabLayoutMediator和ViewPager2都是final类，没法直接继承重写内部的默认逻辑。不过我们可以通过拦截Tab的点击事件来绕过默认的平滑滚动行为，这里有个简单且靠谱的方案：

核心思路

TabLayoutMediator默认会给每个Tab绑定点击事件，触发时调用viewPager.setCurrentItem(position, true)开启平滑滚动。我们只需要在Tab配置阶段，给每个Tab设置自定义的点击监听器，手动调用禁用平滑滚动的setCurrentItem(position, false)，同时替代默认的点击处理逻辑即可。

代码实现（Kotlin示例）

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

// 先给ViewPager2设置适配器
viewPager.adapter = YourCustomPagerAdapter(this)

// 初始化TabLayoutMediator，重点在configureTab回调中自定义点击逻辑
TabLayoutMediator(tabLayout, viewPager) { tab, position ->
    // 正常配置Tab的文本、图标等内容
    tab.text = "Tab $position"
    
    // 设置自定义点击监听器，替代Mediator的默认行为
    tab.view.setOnClickListener {
        // 直接跳转目标页面，禁用平滑滚动
        viewPager.setCurrentItem(position, false)
    }
}.attach()

为什么你的之前尝试有问题？

方案1：通过registerOnPageChangeCallback重写onPageSelected再调用setCurrentItem(false)，会触发循环调用——setCurrentItem会再次触发onPageSelected，陷入死循环，完全不可行。
方案2：给TabLayout添加OnTabSelectedListener，此时Mediator的默认监听器已经先执行了setCurrentItem(true)，你后续调用的setCurrentItem(false)会打断平滑动画，导致页面跳转出现“闪跳”的奇怪体验，还可能触发额外的页面状态回调。