Android自定义TabLayout标题图标点击事件不响应问题排查

问题原因 #

核心原因是图标TextView拦截了触摸事件。TextView默认具备可点击（clickable）和可获取焦点（focusable）的特性，当点击图标区域时，触摸事件被该TextView直接消耗，没有传递给外层的TabLayout标签容器，导致TabLayout无法触发标签切换逻辑。

修复方案 #

只需要让图标TextView不再拦截触摸事件即可，有两种实现方式：

方式1：在布局文件中添加属性 #

修改tab_item_header.xml里的图标TextView，增加android:clickable="false"和android:focusable="false"：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <!-- Icon -->
    <TextView style="@style/some_style"
        android:id="@+id/tvIcon"
        android:layout_width="20sp"
        android:layout_height="20sp"
        android:layout_gravity="center"
        android:background="@color/transparent"
        android:textColor="@color/white"
        android:textSize="20sp"
        android:text="@string/some_icon"
        android:clickable="false"
        android:focusable="false" />

    <!-- Name -->
    <TextView style="@style/Theme.SubTitle2"
        android:id="@+id/tvName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:textColor="@color/White74"
        android:text="Name" />
</LinearLayout>

方式2：在代码中动态设置 #

如果需要在逻辑中控制，也可以在Fragment的代码里添加：

TabLayoutMediator(tlTabs!!, viewPager!!) { tab, position ->
    val layoutInflater = LayoutInflater.from(context)
    val view: View = layoutInflater.inflate(R.layout.tab_item_header, null)
    val tvIcon = view.findViewById(R.id.tvIcon) as TextView
    val tvName = view.findViewById(R.id.tvName) as TextView

    tvIcon.text = someMethodToGetCodeForIcon()
    tvName.text = resources.getString(fragmentList[position].second)
    // 禁止图标TextView拦截事件
    tvIcon.isClickable = false
    tvIcon.isFocusable = false

    tab.setCustomView(view)
}.attach()

原理说明 #

当控件的clickable或focusable设为true时，它会在触摸事件分发过程中消费事件，阻止事件向上传递给父容器。将这两个属性设为false后，触摸事件会穿透到TabLayout的标签项，触发TabLayout内置的点击切换逻辑。

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