目录

ArkUI_NodeAttributeType(无障碍相关属性)

enum ArkUI_NodeAttributeType

概述

定义ArkUI在Native侧可以设置的无障碍相关属性集合,包含无障碍文本、说明、模式、状态、值等属性设置。

起始版本: 12

相关模块: ArkUI_NativeModule

所在头文件: native_node.h

NODE_ACCESSIBILITY_GROUP

NODE_ACCESSIBILITY_GROUP = 62

无障碍组属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.value[0].i32 为1时表示该组件及其所有子组件为一整个可以选中的组件,无障碍服务将不再关注其子组件内容;为0时表示子组件各自独立可被选中,无障碍服务将分别关注其各子组件内容。参数取值为1或0,传入非法值时该设置不生效。

返回:

类型 说明
.value[0].i32 为1时表示该组件及其所有子组件合并为一个可被无障碍服务整体聚焦的组件,无障碍服务将不再单独关注其子组件内容;为0时表示不启用无障碍分组,各子组件可被无障碍服务单独关注。参数取值为1或0。

NODE_ACCESSIBILITY_TEXT

NODE_ACCESSIBILITY_TEXT = 63

无障碍文本属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.string 无障碍文本,无长度限制。

返回:

类型 说明
.string 组件的无障碍文本内容,用于在无障碍服务中朗读或展示该组件的文本描述。

NODE_ACCESSIBILITY_MODE

NODE_ACCESSIBILITY_MODE = 64

无障碍辅助服务模式,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.value[0].i32 辅助服务模式,参数类型为ArkUI_AccessibilityMode。

返回:

类型 说明
.value[0].i32 辅助服务模式,参数类型ArkUI_AccessibilityMode。

NODE_ACCESSIBILITY_DESCRIPTION

NODE_ACCESSIBILITY_DESCRIPTION = 65

无障碍说明属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.string 无障碍说明,无长度限制。

返回:

类型 说明
.string 组件的无障碍说明内容,用于向无障碍服务补充描述该组件的详细用途或操作指引。

NODE_ACCESSIBILITY_ID

NODE_ACCESSIBILITY_ID = 87

无障碍自定义标识ID,支持属性获取。

作为属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

返回:

类型 说明
.value[0].i32 无障碍自定义标识ID。

NODE_ACCESSIBILITY_ACTIONS

NODE_ACCESSIBILITY_ACTIONS = 88

无障碍操作类型属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.value[0].u32 配置无障碍操作类型,参数类型ArkUI_AccessibilityActionType。

返回:

类型 说明
.value[0].u32 配置无障碍操作类型,参数类型ArkUI_AccessibilityActionType。

NODE_ACCESSIBILITY_ROLE

NODE_ACCESSIBILITY_ROLE = 89

定义无障碍角色属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.value[0].u32 无障碍角色,参数类型ArkUI_NodeType。

返回:

类型 说明
.value[0].u32 无障碍组件类型,参数类型ArkUI_NodeType。

NODE_ACCESSIBILITY_STATE

NODE_ACCESSIBILITY_STATE = 90

定义无障碍状态属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.object 无障碍状态信息,参数类型ArkUI_AccessibilityState。

返回:

类型 说明
.object 返回值类型为ArkUI_AccessibilityState。

NODE_ACCESSIBILITY_VALUE

NODE_ACCESSIBILITY_VALUE = 91

定义无障碍值属性,支持属性设置、属性重置和属性获取。

作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项 描述
.object 无障碍值信息,参数类型为ArkUI_AccessibilityValue。

返回:

类型 说明
.object 返回值类型为ArkUI_AccessibilityValue。