Android开发中如何监听Toolbar菜单内SwitchCompat的切换事件

监听器无法触发核心是两个问题：

1. 绑定时机错误：你把setOnCheckedChangeListener逻辑写在了onOptionsItemSelected回调里，这个回调只有用户点击菜单项时才会触发，等于第一次点击开关时才会绑定监听器，自然无法响应状态变化，后续也会因为事件拦截出现异常。
2. 菜单配置冲突：你同时给item配置了app:actionLayout和app:actionViewClass两个属性，两个属性同时生效会导致actionView实例和预期不一致，点击事件被上层拦截。

1. 修正菜单XML配置 #

两个属性二选一，不要同时声明：
如果不需要自定义复杂布局，直接用SwitchCompat作为actionView，就删除actionLayout属性：

<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools">

<item
    android:id="@+id/map_toggle"
    android:title="Switch"
    app:actionViewClass="androidx.appcompat.widget.SwitchCompat"
    app:showAsAction="always" />
</menu>

如果需要保留自定义的switch_item布局，就删除app:actionViewClass属性，后续获取Switch实例时通过actionView.findViewById<SwitchCompat>(R.id.你布局里switch的id)拿实例即可。

2. 提前在菜单创建完成时绑定监听器 #

不要在onOptionsItemSelected里做监听器绑定，移到onCreateOptionsMenu回调中，菜单加载完成后就拿到Switch实例完成初始化：

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    menuInflater.inflate(R.menu.你的菜单资源id, menu)

    // 获取开关对应的菜单项
    val toggleItem = menu.findItem(R.id.map_toggle)
    val mapSwitch = toggleItem.actionView as SwitchCompat
    
    // 绑定选中状态变化监听器
    mapSwitch.setOnCheckedChangeListener { _, isChecked ->
        Toast.makeText(requireContext(), "开关状态：$isChecked", Toast.LENGTH_SHORT).show()
        // 此处写开关状态对应的业务逻辑
    }

    // 可选配置：点击菜单项任意区域都触发开关切换
    toggleItem.setOnMenuItemClickListener {
        mapSwitch.isChecked = !mapSwitch.isChecked
        true
    }

    return true
}

3. 清理冗余代码 #

把之前写在onOptionsItemSelected中针对R.id.map_toggle的监听器绑定代码删掉，普通菜单项的点击逻辑可以继续保留在onOptionsItemSelected中正常处理。

• 自定义actionLayout时，要确保SwitchCompat控件没有设置android:clickable="false"，也没有被其他布局控件遮挡点击区域
• 如果需要记录开关状态，不要依赖菜单项点击事件，直接以OnCheckedChangeListener返回的状态为准即可
• 如果开关状态需要和页面生命周期绑定，可以在onResume、onPause等生命周期中同步选中状态，避免状态错乱

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