如何为按钮和文本添加正确的 contentDescription 以支持屏幕阅读器？

返回 兼容与平台扩展 目录

标准回答

可读标签要补充控件意义，避免把已经可见的文字重复读两遍。

通俗例子

只有垃圾桶图标的按钮可标“删除笔记”；普通 TextView 已有清楚文本通常无需重复添加同样描述，装饰图片应避免成为噪声。

深入解释

**描述应该表达什么：**图标按钮要告诉用户用途，例如“暂停播放”，不是仅说“一个三角形”。状态变化后，辅助服务获得的信息也应与当前操作一致。

**什么时候无需重复添加：**已有明确文字且能被正常读取的控件，重复描述可能导致冗余播报。装饰性图片应避免抢占阅读焦点，自绘多目标控件要分别暴露操作目标。

内容来源

• Android · AI Agent 知识手册 · 原条目 16.4.3