组件可以设置相应的无障碍属性和事件来更好地使用无障碍能力。
说明:
从API Version 10 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
accessibilityGroup
accessibilityGroup(value: boolean)
无障碍组。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | boolean | 是 | 无障碍组,设置为true时表示该组件及其所有子组件为一整个可以选中的组件,无障碍服务将不再关注其子组件内容。 默认值:false |
accessibilityText
accessibilityText(value: string)
无障碍文本。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | string | 是 | 无障碍文本,当组件不包含文本属性时,屏幕朗读选中此组件时不播报,使用者无法清楚地知道当前选中了什么组件。为了解决此场景,开发人员可为不包含文字信息的组件设置无障碍文本,当屏幕朗读选中此组件时播报无障碍文本的内容,帮助屏幕朗读的使用者清楚地知道自己选中了什么组件。 默认值:“” 说明: 若组件既拥有文本属性,又拥有无障碍文本属性,则组件被选中时,仅播报无障碍文本内容。 若组件设置了无障碍分组属性为true,但是即没有无障碍文本属性,也没有文本属性,会对其子节点的组件进行文本拼接(深度优先)。 |
accessibilityDescription
accessibilityDescription(value: string)
无障碍说明。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 |
---|