Android中Material Chip选择状态变更监听失效问题排查

问题说明 #

创建了一组Material Chip，点击Chip时，chipGroup.setOnCheckedStateChangeListener监听未触发，无法根据Chip选择状态更新逻辑。

原实现代码 #

Kotlin 代码 #

class MainFragment : Fragment() {

    private var _binding: FragmentLayoutBinding? = null
    private val binding get() = _binding!!

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        _binding = FragmentLayoutBinding.inflate(inflater, container, false)
        return binding.root
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        binding.chipGroup.setOnCheckedStateChangeListener { _, checkedIds ->
            val chip: Chip? = view.findViewById(checkedIds[checkedIds.size - 1])
            chip?.let {
                when (chip.id) {
                    // 未实现具体逻辑
                }
            }
        }
    }
}

XML 布局 #

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <HorizontalScrollView
        android:id="@+id/chips_list"
        android:layout_width="match_parent"
        android:layout_below="@+id/toolbar"
        android:layout_height="wrap_content"
        android:layout_marginLeft="20.dp"
        android:scrollbars="none">

        <com.google.android.material.chip.ChipGroup
            android:id="@+id/chip_group"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:singleLine="true"
            app:singleSelection="true">

            <com.google.android.material.chip.Chip
                android:id="@+id/chip_one"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:checked="true"
                android:text="One" />

            <com.google.android.material.chip.Chip
                android:id="@+id/chip_two"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Two" />

        </com.google.android.material.chip.ChipGroup>
    </HorizontalScrollView>
</RelativeLayout>

排查与修复方案 #

1. 开启Chip的点击交互能力 #

部分版本的Material Chip默认未启用点击触发选中的功能，需在XML的每个Chip中添加app:chipClickable="true"：

<com.google.android.material.chip.Chip
    android:id="@+id/chip_one"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:checked="true"
    android:text="One"
    app:chipClickable="true" />

<com.google.android.material.chip.Chip
    android:id="@+id/chip_two"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Two"
    app:chipClickable="true" />

2. 优化监听逻辑，避免视图查找错误 #

利用视图绑定直接通过ID判断选中状态，替代view.findViewById，减少出错概率：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    binding.chipGroup.setOnCheckedStateChangeListener { _, checkedIds ->
        if (checkedIds.isNotEmpty()) {
            when (checkedIds[0]) {
                R.id.chip_one -> {
                    // 处理Chip One选中逻辑
                }
                R.id.chip_two -> {
                    // 处理Chip Two选中逻辑
                }
            }
        }
    }
}

3. 校验视图绑定正确性 #

确认FragmentLayoutBinding是对应布局文件的自动生成绑定类，且布局中ChipGroup的IDchip_group与代码中binding.chipGroup完全匹配。

4. 补充视图绑定销毁逻辑（推荐） #

在Fragment的onDestroyView方法中置空绑定对象，避免内存泄漏：

override fun onDestroyView() {
    super.onDestroyView()
    _binding = null
}

5. 升级Material组件库版本 #

确保项目依赖的Material组件库为最新稳定版，规避旧版本的已知bug。在Module级build.gradle中检查：

implementation 'com.google.android.material:material:1.11.0' // 或更高稳定版

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