可访问名称和描述计算 1.1

4.1 名称计算

用户代理 必须按照下方可访问名称与描述计算章节中列出的规则，计算可访问名称。

4.2 描述计算

如果存在aria-describedby，用户代理 必须通过将当前元素上的 aria-describedby 属性所引用元素的文本替代拼接起来，计算可访问描述。引用元素的文本替代的计算方法详见下方 可访问名称与描述计算章节。

4.3 可访问名称与描述计算

可访问名称与描述计算用于生成可访问名称和 可访问描述。针对不同类型的元素、节点和标记组合，分别有不同规则。文本替代在需要时，将从元素所包含的所有相关内容构建。通过步骤2B和2F实现递归，使用完整规则从其子节点或引用节点获取文本。

该计算的目的是为替代展示生成一个可感知的标签或描述，形式为以空格分隔的扁平字符串。

某个元素的文本替代计算如下：

1. 初始化：将 根节点设为指定元素，当前节点设为根节点，累计文本总量设为空字符串 ("")。
2. 计算当前节点的文本替代：
   1. 如果当前节点隐藏，且不是被aria-labelledby或aria-describedby直接引用，也不是被宿主语言文本替代元素（如 HTML 中的 label）或属性直接引用，则返回空字符串。
      注释：

      默认情况下，辅助技术不会传递隐藏信息，但作者可以通过aria-labelledby或aria-describedby显式包含隐藏文本作为可访问名称或可访问描述的一部分。

   2. 否则：
      • 如果正在计算名称，且当前节点有 aria-labelledby 属性，且包含至少一个有效 IDREF，且当前节点未作为aria-labelledby遍历的一部分，则按顺序处理其 IDREF：
      • 或者，如果正在计算描述，且当前节点有 aria-describedby 属性，且包含至少一个有效 IDREF，且当前节点未作为aria-describedby遍历的一部分，则按顺序处理其 IDREF：
        1. 将累计文本设为空字符串。
        2. 对于每个 IDREF：
           1. 将当前节点设为该 IDREF 所引用的节点。
           2. 从步骤2开始计算当前节点的文本替代。将结果设为该文本替代。
           3. 将结果有空格追加到累计文本。
        3. 返回累计文本。
      示例：

      以下示例展示了“…且当前节点未作为aria-labelledby遍历的一部分…”的含义。

      • element1的可访问名称为“hello”，因为这是首次遍历其aria-labelledby，指向element3。
      • element2没有可访问名称。计算会首次遍历其aria-labelledby，指向element1，但不会随后遍历element1的aria-labelledby。

      示例 1

      <element1 id="el1" aria-labelledby="el3" />
      <element2 id="el2" aria-labelledby="el1" />
      <element3 id="el3"> hello </element3>

   3. 否则，如果正在计算名称，且当前节点有aria-label 属性，且其值不为空字符串，或去除空白后不为空字符串：
      • 如果因递归遍历当前节点且该节点为嵌入式控件（详见步骤2E），则忽略aria-label，直接跳到规则2E。
      • 否则，返回aria-label的值。
      示例：

      以下示例展示当节点的aria-labelledby引用自身时，aria-labelledby和aria-label的交互。<span role="button">元素的可访问名称分别为“删除 Documentation.pdf”和“删除 HolidayLetter.pdf”。

      示例 2

      <h1>Files</h1>
      <ul>
        <li>
          <a id="file_row1" href="./files/Documentation.pdf">Documentation.pdf</a>
          <span role="button" tabindex="0" id="del_row1" aria-label="Delete" aria-labelledby="del_row1 file_row1"></span>
        </li>
        <li>
          <a id="file_row2" href="./files/HolidayLetter.pdf">HolidayLetter.pdf</a>
          <span role="button" tabindex="0" id="del_row2" aria-label="Delete" aria-labelledby="del_row2 file_row2"></span>
        </li>
      </ul>

   4. 否则，如果当前节点的原生标记提供了定义文本替代的属性 （如title）或元素（如 HTML label），则返回主语言定义的该文本替代，格式为扁平字符串，除非该元素被标记为展示性（role="presentation" 或 role="none"）。
      注释：

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

   5. 否则，如果当前节点是嵌入在标签（如 HTML 的 label 元素，或被 aria-labelledby 直接引用的任何元素）中的控件，并且用户可以调整嵌入控件的值，则作为文本替代的一部分包含嵌入控件，具体如下：
      • 如果嵌入控件的角色为 textbox，返回其值。
      • 如果嵌入控件的角色为菜单 button，返回按钮的文本替代。
      • 如果嵌入控件的角色为 combobox 或 listbox，返回所选选项的文本替代。
      • 如果嵌入控件的角色为 range（如 spinbutton 或 slider）：
        • 如果存在 aria-valuetext 属性，返回其值，
        • 否则如果存在 aria-valuenow 属性，返回其值，
        • 否则，使用宿主语言属性指定的值。
      示例：

      例如某个复选框标签内包含一个文本输入域：“闪烁屏幕 [输入] 次”。如果用户为嵌入文本框输入了“5”，完整标签即为“闪烁屏幕 5 次”，如：

      示例 3

      <div role="checkbox" aria-checked="false">Flash the screen <span role="textbox" aria-multiline="false"> 5 </span> times</div>

   6. 否则，如果当前节点的角色允许content 来源名称，或当前节点被aria-labelledby、aria-describedby引用，或为原生宿主语言文本替代元素（如 HTML 的 label），或为原生宿主语言文本替代元素的后代节点：
      1. 将累计文本设为空字符串。
      2. 检查与当前节点相关的 CSS 生成文本内容，并将其包含进累计文本。CSS :before 和 :after 伪元素 [CSS2] 可为有内容模型的元素提供文本内容。
         • 对于 :before 伪元素，用户代理 必须无空格前置CSS文本内容到当前节点的文本内容。
         • 对于 :after 伪元素，用户代理 必须无空格追加CSS文本内容到当前节点的文本内容。
      3. 对当前节点的每个子节点：
         1. 将当前节点设为子节点。
         2. 从步骤2开始计算当前节点的文本替代。将结果设为该文本替代。
         3. 将结果追加到累计文本。
      4. 返回累计文本。

      重要：子树中的每个节点仅被访问一次。如果已从某后代收集文本，但在其他后代节点通过 IDREF 再次引用，则不再处理该引用，以避免无限循环。

      注释：

      此步骤可作用于子节点自身，即计算是递归的，会收集当前节点子树所有元素的文本，无论层级多深。然而，任何后代节点的文本替代都可能来自上述步骤B到D中更高优先级的标记（如“Namefrom: author”属性为整个子树提供文本替代）。

   7. 否则，如果当前节点是文本节点，则返回其文本内容。
   8. 否则，如果当前节点是正在计算可访问名称或可访问描述的元素的后代，并且包含后代节点，则转到2F.i。
   9. 否则，如果当前节点有提示属性，则返回其值。
      注释：

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

   将上述每一步的结果有空格追加到累计文本总量。

所有步骤完成后，累计文本总量将作为发起计算的元素的可访问名称或可访问描述。