如何使用Jetpack Compose构建无障碍Android应用：全面指南
内容提要
本文全面介绍在Jetpack Compose中实现移动应用无障碍访问的指南。文章强调无障碍不仅是法律要求（如欧洲无障碍法案），更是良好的工程实践。核心内容包括：理解Compose语义树、使用contentDescription和语义修饰符、确保48dp触摸目标、维持WCAG对比度、支持动态字体缩放、创建自定义无障碍操作，以及通过TalkBack、Accessibility Scanner和自动化测试进行验证。
延伸解读
无障碍不仅是合规，更是产品力
文章指出，全球有超过13亿人（约占总人口16%）存在显著残障，且临时或情境性限制（如单手操作、强光下使用手机）也会影响所有用户。将无障碍融入开发，不仅能避免法律风险（如欧洲无障碍法案、美国ADA），还能扩大潜在用户群、提升留存率。这提示开发者应将无障碍视为产品体验的一部分，而非发布前的附加项。
语义树是Compose无障碍的核心
Compose通过语义树向TalkBack等辅助服务传递界面信息，而非直接读取像素。标准组件自动填充语义，但自定义布局需手动使用semantics修饰符。理解并善用mergeDescendants、clearAndSetSemantics等工具，能有效合并冗余节点、避免屏幕阅读器逐字朗读，提升导航效率。
对比度与触摸目标：容易被忽视的硬指标
文章强调WCAG对比度要求（正文4.5:1，大文本3:1）和Android 48dp触摸目标标准。这些指标看似简单，却常被忽视。使用Material 3颜色令牌可自动保证对比度，而minimumInteractiveComponentSize()能在保持视觉紧凑的同时扩大点击区域。建议在开发中定期用Accessibility Scanner检查，避免发布后返工。
动态内容与状态描述：让屏幕阅读器“看见”变化
对于异步更新（如上传进度）和可交互状态（如播放/暂停），需通过liveRegion和stateDescription主动告知辅助服务。否则，屏幕阅读器用户无法感知界面变化。文章示例展示了如何用Polite模式播报状态更新，以及如何用stateDescription明确当前状态，这些细节对提升无障碍体验至关重要。
Q&A
为什么在Jetpack Compose中实现无障碍访问很重要？
因为全球有超过13亿人（约占16%）存在显著残疾，无障碍设计能确保所有人都能使用应用。此外，欧洲无障碍法案（EAA）等法规要求数字产品和服务必须无障碍，否则可能面临法律处罚和品牌损害。同时，无障碍应用也能提升所有用户的体验，扩大潜在受众。
Jetpack Compose中的语义树是什么？它如何帮助无障碍服务？
语义树是Compose生成的一个与布局树并行的树结构，包含元素的元数据，如内容描述、角色、状态和操作。无障碍服务（如TalkBack）不直接读取视觉像素，而是读取语义树来向用户提供反馈。标准组件会自动填充语义属性，但自定义组件需要手动使用语义修饰符来丰富语义树。
如何为图标和图片设置内容描述？
使用contentDescription参数为图标和图片提供文本描述。对于功能性图标，描述应说明其操作，如“打开相机”。对于装饰性元素，应设置为null以告知TalkBack跳过该节点。避免使用“图标”或“按钮”等冗余词汇，因为TalkBack会自动播报角色。
如何确保触摸目标大小符合无障碍要求？
Android要求所有交互元素的最小触摸目标为48dp×48dp。可以使用Modifier.minimumInteractiveComponentSize()来扩展触摸区域，同时保持视觉尺寸较小。标准IconButton默认提供48dp的触摸目标。避免使用小于48dp的触摸区域，否则会被Accessibility Scanner标记。
如何支持动态字体缩放？
在Compose中，应使用sp单位定义文本大小，而不是dp或像素。Material Typography默认使用sp，因此推荐使用MaterialTheme.typography。避免使用dp转sp的固定大小，因为那不会随系统字体设置缩放。这样用户增大系统字体时，应用文本会相应放大。
如何为可点击元素提供自定义的无障碍标签？
使用Modifier.clickable的onClickLabel参数，可以自定义TalkBack播报的操作说明。例如，对于Wi-Fi列表项，可以设置onClickLabel = "打开Wi-Fi网络设置"，这样TalkBack会播报“Wi-Fi网络，已连接Office_5G，双击打开Wi-Fi网络设置”，让用户明确操作结果。
如何合并多个子元素的语义以简化TalkBack导航？
使用Modifier.semantics(mergeDescendants = true)可以将多个子元素合并为一个单一的无障碍节点。例如，一个包含图标、文本和评分的行可以合并为一个节点，并设置统一的contentDescription，这样TalkBack只播报一次，而不是多次。
如何为动态内容设置实时区域？
使用Modifier.semantics中的liveRegion属性，可以设置LiveRegionMode.Polite或Assertive。Polite模式会等待当前播报完成后再播报更新，适用于大多数状态更新；Assertive模式会立即播报，用于紧急警报。例如，上传完成时，可以设置liveRegion = LiveRegionMode.Polite，这样TalkBack会自动播报“上传完成”。
如何创建自定义无障碍操作？
使用Modifier.semantics中的customActions属性，可以添加自定义操作。例如，在卡片上添加“添加到书签”和“分享链接”操作。TalkBack用户聚焦卡片时，会被告知有自定义操作，并可通过菜单选择。每个操作需要提供标签和动作回调。
如何测试应用的无障碍性？
测试方法包括：使用TalkBack手动测试，检查关键流程是否可用；使用Google Accessibility Scanner扫描屏幕，发现触摸目标和对比度问题；使用Android Studio的Layout Inspector检查语义树；编写Compose UI测试，断言节点存在、具有点击动作和最小尺寸。
