可访问名称和描述计算 1.2

根节点

正在为其寻求文本 替代的 DOM 节点或元素。

当前节点

为计算 root node 的文本等价而当前遍历到的 DOM 节点。最初，current node 是 root node，但在后续阶段，它要么是 root node 的某个后代，要么是另一个被引用的节点。

渲染后的子节点

在考虑影子 根和插槽时，被渲染为给定节点的子节点的节点。

扁平字符串

一个字符字符串，其中所有回车、换行、制表符和换页符都被替换为 一个空格，并且多个空格会被压缩为一个空格。该字符串仅包含 字符数据；不包含任何标记。

总累计文本

截至但不包括 current node 时已经计算出的文本等价。

累计文本

在下文描述的某个步骤或一系列步骤中累计的文本。它是 这些步骤的临时存储。

结果

在下文描述的某个步骤中计算出的文本等价。

将结果附加到 X，前面不加空格

• 如果 X 为空，则将 result 复制到 X。
• 如果 X 非空，则将 result 复制到 X 的末尾。

将结果附加到 X，前面加空格

• 如果 X 为空，则将 result 复制到 X。
• 如果 X 非空，则在 X 的末尾添加一个空格，然后将 result 复制到 该空格之后的 X 中。

将结果前置到 X，后面不加空格

• 如果 X 为空，则将 result 复制到 X。
• 如果 X 非空，则将 result 复制到 X 的开头。

将结果前置到 X，后面加空格

• 如果 X 为空，则将 result 复制到 X。
• 如果 X 非空，则将 result 复制到 X 的开头，并在 该副本之后添加一个空格。

给定元素的文本替代按如下方式计算：

1. 初始化： 将 root node 设置为给定 元素，将 current node 设置为 root node，并将 total accumulated text 设置为空字符串 ("")。如果 root node 的角色禁止命名，则返回空字符串 ("")。
2. 计算： 计算 current node 的文本替代：
   1. 隐藏且未被引用： 如果 current node 是 隐藏的 并且是：
      1. 不是 aria-labelledby 或 aria-describedby 遍历的一部分，其中由 该关系直接引用的节点是隐藏的。
      2. 也不是 原生宿主语言文本替代元素（例如 HTML 中的 label）或 属性 遍历的一部分，其中该遍历的根是隐藏的。
      返回空字符串。
      注

      重要的是要阐明用于可访问名称计算目的的隐藏的广义定义：

      1. 具有 CSS 属性 display:none、visibility:hidden、 visibility:collapse 或 content-visibility:hidden 的节点：它们 被认为是隐藏的，因为它们符合“不可感知”和 “显式隐藏”的准则。
      2. 具有 CSS 属性 opacity:0 或 filter:opacity(0%)，或类似 SVG 机制的节点：它们 不被认为是隐藏的。用这些方法隐藏的文本 仍然可以被选中或复制，并且用户代理仍会在 其可访问性树中公开它。
      3. 具有 aria-hidden="true" 属性的节点：它被 认为是隐藏的，符合“显式隐藏”准则。
      4. 在屏幕外或位于另一个对象后面而隐藏的节点：它们不 被认为是隐藏的。它们会在可访问性树中公开，并且 甚至可以为屏幕上的对象命名。
      注

      默认情况下，辅助技术不会 传达隐藏信息，但作者可以显式覆盖这一点，并通过 使用 aria-labelledby 或 aria-describedby 将隐藏文本作为 可访问 名称或可访问描述的一部分 包含进来。

   2. LabelledBy： 否则，如果 current node 具有一个 aria-labelledby 属性，其中包含至少 一个有效 IDREF，并且 current node 尚未作为正在进行的 aria-labelledby 或 aria-describedby 遍历的一部分，则按 IDREF 出现的顺序处理它们：
      1. 将 accumulated text 设置为空 字符串。
      2. 对于每个 IDREF：
         1. 将 current node 设置为 该 IDREF 所引用的节点。
         2. LabelledBy 遍历： 从总体计算步骤开始，计算 current node 的文本替代。将 result 设置为该文本替代。
         3. 将一个空格字符和 result 附加到 accumulated text。
      3. 如果 accumulated text 不是 空字符串 ("")，则返回它。

      LabelledBy 遍历与 隐藏且未被引用结合后的结果 意味着，当由 aria-labelledby 或 aria-describedby 引用的节点是隐藏的时， 用户代理MUST 将子树中的所有节点都作为可访问名称 或可访问 描述的一部分包含进来。

   3. 嵌入控件： 否则，如果 current node 是另一个部件的标签 （例如由 aria-labelledby 直接引用的任何元素）中嵌入的控件， 且用户可以调整该嵌入控件的值，则按如下方式将 该嵌入控件作为文本替代的一部分返回：
      1. 文本框： 如果嵌入控件的角色为 textbox，则返回其 值。
      2. 组合框/列表框： 如果嵌入控件的角色为 combobox 或 listbox， 则返回所选选项的文本替代。
      3. 范围： 如果嵌入控件的角色为 range（例如 spinbutton 或 slider）：
         1. 如果存在 aria-valuetext 属性，则返回其值，
         2. 否则，如果存在 aria-valuenow 属性，则返回其值，
         3. 否则，使用由宿主语言属性指定的 值。
   4. AriaLabel： 否则，如果 current node 不是 slot 元素，并且具有一个 aria-label 属性，其值 不是 undefined，不是空字符串，也不是在去除空白后为 空字符串：
      1. 如果对 current node 的遍历是由于Name From Content 后代 节点递归，并且 current node 是嵌入控件，则忽略 aria-label 并跳至规则 嵌入控件。
      2. 否则，返回 aria-label 的值。
   5. 宿主语言标签： 否则，如果 current node 的原生标记提供了一个定义文本 替代的属性（例如 alt）或元素（例如 HTML label 或 SVG title），则以 宿主语言定义的 flat string 形式返回该替代（例如 HTML-AAM），除非 current node 被公开为呈现性（role="presentation" 或 role="none"、alt=""）。
      注

      重要！原生 HTML 元素的可访问名称可能会根据宿主语言 以不同方式计算。请务必查阅 HTML-AAM 以获取更多 信息。
      注

      例如，在 HTML 中， img 元素的 alt 属性定义文本 替代字符串，而 label 元素为被引用的表单元素提供文本。在 SVG2 中，desc 和 title 元素提供其父元素的 描述。

   6. 由内容提供名称： 否则，如果 current node 的角色允许 由 内容提供名称，或者如果 current node 由 aria-labelledby、aria-describedby 引用，或者 是原生宿主语言文本替代元素（例如 HTML 中的 label），或者是 原生宿主语言文本替代元素的后代：
      1. 由内容提供名称重置： 将 accumulated text 设置为空字符串。
      2. 由生成内容提供名称： 检查与 current node 关联的 CSS 生成文本内容，并将其包含在 accumulated text 中。 CSS ::before 和 ::after 伪元素 [CSS2] 可以为具有内容模型的元素提供文本内容，此外还有 ::marker 伪元素。
         1. 对于 ::marker 伪元素，用户代理MUST 将 CSS 文本内容前置到 current node 的文本内容之前，不加 空格，前提是 current node 支持 ::marker。
         2. 对于 ::before 伪元素，用户代理MUST 将 CSS 文本内容前置到 current node 的文本内容之前，不加 空格。
         3. 对于 ::after 伪元素，用户代理MUST 将 CSS 文本内容附加到 current node 的文本内容之后，不加 空格。
      3. 确定子节点： 确定 current node 的 rendered child nodes：
         1. 如果 current node 具有一个已附加的影子 根，则将 rendered child nodes 设置为该影子 根的子 节点。
         2. 否则，如果 current node 是具有已分配 节点的slot，则将 rendered child nodes 设置为 current node 的已分配 节点。
         3. 否则，将 rendered child nodes 设置为 current node 的子节点。
      4. 从每个子节点取得名称： 对 current node 的每个 rendered child node：
         1. 将 current node 设置为 rendered child node。
         2. 从总体 计算步骤开始，计算 current node 的文本替代。将 result 设置为该文本替代。
         3. 将 result 附加到 accumulated text。
      5. 如果 accumulated text 不是 空字符串 ("")，则返回它。

      重要：子树中的每个节点只会 被查询一次。如果已从某个后代收集了文本，但该后代又被某个 后代节点中的另一个 IDREF 引用，则不会跟随第二个或后续的引用。这是 为了避免无限循环。

      注

      此步骤可以应用于子节点本身，这意味着 计算是递归的，并会从 current node 的 子树中的所有元素收集文本，无论其深度如何。不过，任何给定后代节点的文本 替代都可能来自上文步骤 B 到 D 中描述的更高优先级标记， 其中“Namefrom: author”属性为 整个子树提供文本替代。

      注

      2024 年 1 月 18 日：ARIA 工作组正在考虑 根据 current node 及其相邻节点和伪元素的 CSS display 值， 以带空格或不带空格的方式连接文本字符串的可行性。 正在进行的讨论见 AccName #225。

   7. 文本节点： 否则，如果 current node 是一个文本节点，则返回 其文本内容。
   8. 递归地由内容提供名称： 否则，如果 current node 是某个正在计算其可访问名称或可访问 描述的元素的后代，并且包含后代，则继续执行 由内容提供名称重置。
   9. 工具提示： 否则，如果 current node 具有一个工具提示属性， 则返回其值。
      注

      只有在没有任何其他内容（包括子树内容）提供结果时，才使用工具提示属性。

   10. 将一个空格字符以及上面每个步骤的 result 附加到 total accumulated text。
3. 所有步骤完成后，total accumulated text 将用作发起计算的 元素的可访问名称或可访问描述。