fuchsia.accessibility.semantics

默认

与元素相关联的默认操作。

辅助电子邮件

与元素相关的次要操作。这可能对应于长按（触摸屏）或右键点击（鼠标）。

SET_FOCUS

将（输入/非无障碍）焦点设置到此元素上。

SET_VALUE

设置元素的值。

SHOW_ON_SCREEN

滚动节点以使其可见。

减少

将滑块减一级。步长由执行此操作的语义节点的所有者定义。例如，音量滑块可能需要执行第 1 步、第 2 步、第 3 步，而时间滑块可能需要在每步变化执行 30 秒时跳过 30 秒。

增加

将滑块递增一个步长值。步长由执行此操作的语义节点的所有者定义。例如，音量滑块可能需要执行第 1 步、第 2 步、第 3 步，而时间滑块可能需要在每步变化执行 30 秒时跳过 30 秒。

无

在未输入任何数据或元素不是复选框时使用。

已勾选

已选中

未选中

未选中

混合

不确定状态

已启用

已启用元素。

已停用

元素已停用。

确定

不确定状态。

统一

节点还没有标签。

属性

运行时界面中此元素的属性会明确设置其标签。例如，具有 aria-label 的元素。

ATTRIBUTE_EMPTY

运行时界面中此元素的属性明确将其标签设置为空。

图片说明

此标签用作类似表格的元素的标题。由于某些辅助技术具有处理表的特殊模式，因此运行时应使用此类源来标记其标签，以便用户在以表模式进行导航时了解表的内容。例如，<caption> HTML 标记会设置标签。

目录

此节点会根据应用中存在的内容接收标签。例如，网页中的文本将成为此节点的标签。

PLACEHOLDER

一种可以接收用户输入的值并具有建议的输入的元素。例如，HTML 输入字段上的占位符属性。

RELATED_ELEMENT

另一个元素为此元素提供了标签。例如，通过 aria-labeledby。

TITLE

此元素的标签由可视化提示表示。例如，就像来自 <title> HTML 标记一样。

值

该标签来自用户输入的值。

未知

这个角色用于表示当前不支持哪个角色的元素。

按钮

屏幕上具有单一功能的可点击/激活元素。

标题

标题文字，例如 HTML 中标记为 <h1> 的内容。

IMAGE

图片或图形。

TEXT_FIELD

可以接收文本输入的字段。

幻灯片

滑块，例如视频的音量滑块或时间滑块。

链接

链接，例如网页上的链接。

CHECK_BOX

可以切换的复选框。

RADIO_BUTTON

从一组选项中选择一个选项的单选按钮。

列表

用于表示列表的角色。

LIST_ELEMENT

角色，用于表示列表中的元素，包括其标记及其内容。例如，标记为 <li> 的元素或具有 ARIA listitem 角色的元素。

LIST_ELEMENT_MARKER

用于表示列表标记的角色（例如项目符号、编号、罗马数字等）。

STATIC_TEXT

用于表示不可变文本的角色。

TOGGLE_SWITCH

用于表示切换开关的角色。

表格

用于表示元素表的角色。

网格

用于表示网格的角色。例如，具有 aria-grid 角色的元素。

TABLE_ROW

用于表示表的行的角色。

单元格

用于表示表格或网格中单元格的角色。

COLUMN_HEADER

用于表示列标题的角色。例如，一个带有 HTML 标记 <th> 的元素。

ROW_GROUP

角色，用于表示类似 aria-rowgroup 的元素。

段落

用于表示一段文本的角色。

SEARCH_BOX

TEXT_FIELD_WITH_COMBO_BOX

ROW_HEADER

ON

切换开关开启。

OFF

切换开关已关闭。

确定

切换开关处于“不确定”状态。

1

描述应用更改的消息。此消息应本地化为应用所用的语言。

1

元素的主标签。如果标签长度超过 MAX_LABEL_SIZE，则客户端负责截断标签。

2

元素的次级标签。如果标签长度超过 MAX_LABEL_SIZE，则客户端负责截断标签。

3

描述节点上的次要操作（相当于长按或右键点击）应该执行什么操作。

4

如果元素是滑块 / 范围控件，则系统会填充范围属性。

5

如果元素属于某种类型的集合，则填充属性集。例如，相互关联的单选按钮属于同一组。

6

如果节点具有 LIST 角色，则应填充列表属性。请注意，应仅填充 size 和 set_element_ids。

7

如果节点具有 LIST_ELEMENT 角色，并且源自具有 LIST 角色的节点，则应填充列表元素属性。请注意，只能填充 index。

8

元素的层级。例如，在 HTML 或 Markdown 中，标头可以是级别 1 到 6。

9

当相应元素是表格时，系统会填充表格属性。

10

此元素的标签来源。

11

相应元素是否属于虚拟键盘。例如，屏幕键盘上的按键。

12

当相应元素是表格行时，系统会填充表格行属性。

13

当相应元素是表格单元格时，系统会填充表格单元格的属性。

1

代表特定界面中节点的唯一 ID。零被假定为根节点和树的唯一入口点。没有命中时，node_id 不会填充。

2

节点 ID 的有序列表，表示从根节点到命中节点的路径。

1

代表特定界面中节点的唯一 ID。零被假定为根节点和该树的唯一入口点。不允许使用森林。

2

此元素的角色，例如按钮、复选框等。

3

此对象的状态表格，例如“已选中”“可修改”等。

4

此节点的属性表。

5

可在此节点上执行的操作的列表。

6

此节点的子 ID 列表（按遍历顺序）。提供语义树信息的运行时负责确保树中不包含循环。每个节点只能有一个父节点。

7

此元素的本地边界框。

8

从该节点的坐标空间转换为其容器的空间。4x4 以与景观兼容。此矩阵必须采用以下格式

[ Sx 0 0 Tx ] [ 0 Sy 0 Ty ] [ 0 0 Sz Tz ] [ 0 0 0 1 ]

其中 Sx、Sy 和 Sz 是缩放比例，Tx、Ty、Tz 是 x、y 和 z 分量的转换因子。

9

此节点的祖先节点 ID，用作 |transform| 的目标。如果不存在，则会被解读为该节点的父节点。

10

注意：我们即将弃用 transform，改为使用 node_to_container_transform。客户端不得同时设置这两个字段。

从该节点的坐标空间转换为其容器的空间。如果设置了 container_id 字段，则该 ID 会指定容器节点。否则，此节点的父节点是容器节点。

此外，如果设置了 container_id，则在转换为容器的坐标空间时，应用 node_to_container_transform 后，紫红无障碍管理器将通过其容器的 location.min 进行后转换。如果未设置 container_id，系统将不会应用此后翻译版本。

4x4 以与景观兼容。此矩阵必须采用以下格式：

[ Sx 0 0 Tx ] [ 0 Sy 0 Ty ] [ 0 0 Sz Tz ] [ 0 0 0 1 ]

其中 Sx、Sy 和 Sz 是缩放比例，Tx、Ty、Tz 是 x、y 和 z 分量的转换因子。

1

范围控制元素可采用的最小值。

2

范围控制元素可采用的最大值。

3

调用 DECREMENT 或 INCREMENT 操作时，元素应用的步进增量。

1

数据集的大小。

2

集中的元素索引，从 1 开始。

3

此集中其他元素的节点 ID。

1

不推荐

2

复选框的状态。 此字段与 ToggledState 互斥。

3

当前是否选择了相应元素。

4

表示相应元素当前被框架隐藏还是标记为不可见。

5

用户输入的元素值（如果适用）。如果长度超过 MAX_VALUE_SIZE，则由客户端负责截断。

6

如果元素是滑块或范围控件，此字段包含当前值。请注意，它与上面的值字段不同，因为此字段由客户端生成，只由用户进行调整。

7

如果该元素是可滚动的视口，则此字段包含要应用于子级的此节点坐标空间内的 x 和 y 偏移量。此偏移量用于在视口内定位子项，以反映元素的当前滚动。这些值没有任何限制，除了它们必须是有限的之外。

8

切换开关的状态。 仅当相应元素是切换开关元素且与 CheckedState 互斥时，才必须设置此字段。

9

此元素在界面中是否可聚焦。请注意，这不是 a11y 焦点，而是输入焦点。

10

此元素是否具有输入焦点。这与系统焦点相对应。只能为一个元素设置此值。如果多个节点将此值设为“true”，则无法确定行为。

11

具有启用/停用状态的元素的状态。

1

此表格单元格跨越的列数。

已弃用 - 请改用 TableCellAttributes 作为单元节点

2

此表格单元格跨越的行数。

已弃用 - 请改用 TableCellAttributes 作为单元节点

3

此表中的行数。

4

此表中的列数。

5

表列标题的节点 ID。

6

表行标题的节点 ID。

1

此单元格的行索引。

2

此单元格的列索引。

3

此表格单元格跨越的行数。

4

此表格单元格跨越的列数。

1

表格行索引。

1

语义树中一个节点的子节点数上限。

标签字符串的大小上限（以字节为单位）。

消息字符串的大小上限（以字节为单位）。

在一次更新中可以发送的语义节点的数量上限。

语义集中的元素数上限。

语义树的最大深度。

值字符串的大小上限（以字节为单位）。