HarmonyOS屏幕朗读应用适配指导

发布日期
2026-07-26
作者
华为
格式
外部链接

内容摘要

本指导为华为 HarmonyOS 官方开发者文档,面向 Accessibility Kit(无障碍服务),提供屏幕朗读应用适配的具体操作指引。

文档首先提出两条核心开发原则:确保视障用户可通过手势快速、符合逻辑顺序地导航至页面内所有有效 UI 对象;确保用户在获焦的 UI 对象下收到清晰简洁的语音朗读反馈,告知当前所在对象的内容、功能及可执行操作。在标注屏幕朗读内容的场景中,文档说明了显示文本(text)与无障碍文本(accessibilityText)的优先级规则:accessibilityText 优先于 text;文本类控件尽量使用显示文本以确保视障与健全用户信息一致;非文本类控件使用 accessibilityText 提供朗读信息,并附以完整 ArkTS 代码示例。

核心观点

  • 屏幕朗读适配的核心是"聚焦有序 + 朗读清晰",确保视障用户逻辑导航和信息获取无障碍。
  • accessibilityText 与 text 的优先级规则决定了朗读内容的可控性,文本类控件应优先使用显示文本。
  • 三层焦点禁用策略(组/单组件/子组件全部)为不同场景提供精细化控制。
  • 多维嵌套场景的核心原则是避免朗读重复,统一标注在父控件上最为简洁可靠。

完整目录

  • 概述与开发原则
  • 标注屏幕朗读内容的场景(text/accessibilityText)
  • 禁用屏幕朗读焦点的场景(三种方法)
  • 多维嵌套场景处理
  • 无障碍焦点与事件管理

资料链接暂未提供。