为Android的MenuItem设置按钮角色以适配无障碍访问

嘿，我之前也遇到过一模一样的需求——不想改原有点击逻辑，又要让无障碍工具把MenuItem识别成按钮并正确播报。给你分享个亲测有效的方案：

核心思路是复用系统默认生成的MenuItem ActionView，只修改它的无障碍角色描述，完全保留系统原本的点击事件绑定逻辑，不用自己加点击监听。

具体实现步骤 #

1. 在菜单加载完成后，找到目标MenuItem；
2. 等到系统为MenuItem创建好对应的ActionView后，给这个View设置无障碍代理，修改它的角色描述；
3. 系统会自动处理点击事件，你不需要额外修改onOptionsItemSelected的逻辑。

代码示例 #

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    menuInflater.inflate(R.menu.main_menu, menu)
    val settingsMenuItem = menu.findItem(R.id.action_settings)

    // 用post确保ActionView已经被系统初始化完成
    toolbar.post {
        // 获取MenuItem对应的ActionView（系统默认生成的）
        val actionView = settingsMenuItem.actionView ?: run {
            // 如果是带ActionProvider的MenuItem，取它的view
            (settingsMenuItem.actionProvider as? ActionProvider)?.view
        }

        actionView?.let { view ->
            ViewCompat.setAccessibilityDelegate(view, object : AccessibilityDelegateCompat() {
                override fun onInitializeAccessibilityNodeInfo(
                    v: View,
                    info: AccessibilityNodeInfoCompat
                ) {
                    super.onInitializeAccessibilityNodeInfo(v, info)
                    // 设置角色描述为“设置”，无障碍工具会自动补充“按钮”和“双击激活”的播报
                    info.roleDescription = "设置"
                }
            })
        }
    }
    return true
}

为什么这个方案可行？ #

系统默认的MenuItem在渲染时，会自动把点击事件绑定到对应的ActionView上，点击后会正常触发onOptionsItemSelected回调。我们只是在这个View的无障碍节点初始化时，修改了它的角色描述，完全不影响原有逻辑。

对比你之前用自定义action layout的方式，这个方法不需要自己处理点击事件，完美避免了修改应用逻辑的问题。

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