如何关闭Android TabLayout标签长按触发的重复标题提示弹窗（Tooltip）

这个弹窗是Material Components库中TabLayout默认开启的无障碍tooltip特性，原生模板代码会自动将Tab标题设置为tooltip内容，不需要额外查找触发逻辑，可通过以下方法直接禁用：

方法1：动态遍历所有Tab禁用（最适配原生自动生成的模板代码） #

在TabLayout和ViewPager/ViewPager2完成绑定（调用setupWithViewPager方法）后，添加以下代码遍历所有Tab清空tooltip配置：

Kotlin 代码 #

// 等待Tab全部渲染完成后执行
tabLayout.post {
    for (i in 0 until tabLayout.tabCount) {
        tabLayout.getTabAt(i)?.view?.tooltipText = null
    }
}

Java 代码 #

tabLayout.post(() -> {
    for (int i = 0; i < tabLayout.getTabCount(); i++) {
        TabLayout.Tab tab = tabLayout.getTabAt(i);
        if (tab != null && tab.view != null) {
            tab.view.setTooltipText(null);
        }
    }
});

方法2：XML布局静态全局禁用 #

在样式文件中统一配置Tab属性，全局关闭所有Tab的tooltip：

1. 在res/values/styles.xml中添加自定义样式：

<style name="Widget.App.TabLayout" parent="Widget.MaterialComponents.TabLayout">
    <item name="tabStyle">@style/Widget.App.Tab</item>
</style>

<style name="Widget.App.Tab" parent="Widget.MaterialComponents.Tab">
    <item name="android:tooltipText">@null</item>
</style>

2. 在布局文件的TabLayout控件中应用样式：

<com.google.android.material.tabs.TabLayout
    android:id="@+id/tabLayout"
    style="@style/Widget.App.TabLayout"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"/>

方法3：手动创建Tab时直接禁用 #

如果是自行调用newTab()创建Tab实例，创建时直接设置tooltip为空即可：

val tab = tabLayout.newTab()
    .setText("标签名称")
    .apply { tooltipText = null }
tabLayout.addTab(tab)

注意事项 #

• 动态遍历代码必须在Tab生成完成后执行，若在setupWithViewPager之前调用会因为Tab未创建导致不生效
• 该修改仅关闭长按弹窗提示，不影响Tab的其他正常功能

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