HarmonyOS 无障碍开发指南

发布日期
2026-07-26
作者
华为
格式
PDF

内容摘要

本指南为华为 HarmonyOS 官方开发者文档，面向 API Version 10 及以上版本的 ArkUI 框架，系统介绍无障碍属性的开发方法与最佳实践。

文档首先给出无障碍属性总览，涵盖 accessibilityGroup（无障碍组——将多个子组件合并为一个焦点单元）、accessibilityText（读屏器朗读的核心文本）、accessibilityDescription（告知用户如何操作或后果）、accessibilityLevel（控制节点是否参与无障碍遍历）、accessibilityVirtualNode（为自绘制组件提供无障碍节点）、accessibilityChecked（多选选中状态）和 accessibilitySelected（单选选中状态）等核心属性。


核心观点

  • ArkUI 框架提供丰富的无障碍属性集，从分组、文本描述到焦点控制覆盖完整开发场景。
  • accessibilityGroup 结合 accessiblityPreferred 可灵活控制多组件合并朗读策略，深度优先拼接子组件文本。
  • accessibilityLevel 的四级模型（auto/yes/no/no-hide-descendants）为屏幕朗读遍历行为提供精细控制。
  • API 版本逐步演进（10→12→14），无障碍能力随系统迭代持续增强。

完整目录

  • 无障碍属性总览
  • accessibilityGroup（组/优先拼接）
  • accessibilityText / Description / TextHint
  • accessibilityLevel 四级控制
  • accessibilityVirtualNode
  • accessibilityChecked / Selected
  • accessibilityEventType / Focus
下载完整 PDF