SVG 可访问性 API 映射

本规范将某些章节标记为非规范性，也称为资料性。该分类 适用于整个章节。所有其他章节均提供规范性要求。除非另有说明， 声明“本节为非规范性内容”适用于其所有子章节。 此外，所有标记为“注”的文本框都是资料性的。

规范性章节提供了用户代理必须遵循的要求，以使某个实现 符合本规范。本文档中的关键词 MUST、MUST NOT、REQUIRED、SHALL、SHALL NOT、 SHOULD、RECOMMENDED、MAY 和 OPTIONAL 应按照 用于在 RFC 中指明 要求级别的关键词 [rfc2119] 中的说明解释。RFC-2119 关键词以大写格式显示，并 包含在带有 class="rfc2119" 的元素中。当上面显示的关键词被使用，但 不具有该格式时，它们不传达 RFC 2119 意义上的正式信息， 而只是解释性的，即资料性的。本规范尽可能避免此类 用法。

资料性章节和注释提供有助于理解本规范的信息。此类 章节可能包含推荐实践的示例，但为了符合本规范，并不要求遵循这些 建议。

SVG 用户代理 MUST 符合核心 可访问性 API 映射 [CORE-AAM] 中的暴露 WAI-ARIA 语义的一般规则，并包含以下小节中描述的补充内容。

在宿主语言为 SVG，且原生语义如 SVG 元素映射 表、 状态和属性映射一节以及需要额外计算的特殊处理一节所述的情况下， SVG 用户代理 MUST 符合核心可访问性 API 映射 [CORE-AAM] 中的 原生标记语义与 WAI-ARIA 之间的冲突。

对于根据SVG 元素映射 表定义不会创建可访问对象且不得应用任何角色的元素，它们没有隐式角色 语义。 ‘aria-roledescription’ 属性 MUST NOT 暴露在这些元素上。所有其他 SVG 元素在与全局 WAI-ARIA 属性一起使用时， 都具有隐式角色语义，包括 ‘aria-roledescription’。

SVG 用户代理 MUST 符合 核心可访问性 API 映射 [CORE-AAM] 中的 暴露 未直接映射到可访问性 API 属性的属性。

SVG 用户代理 MUST 必须符合核心可访问性 API 映射 [CORE-AAM] 中角色映射一般规则的可访问性 API 计算要求。

本节定义了 SVG2 中的元素如何基于其原生宿主语言 语义，映射到 WAI-ARIA 角色和平台可访问性 API，包括可以应用哪些 WAI-ARIA 角色。 本节直接引用核心可访问性 API 映射 [CORE-AAM] 规范中的 角色映射 ，以及图形可访问性 API 映射 [GRAPHICS-AAM] 规范中的 角色映射，这些规范定义了 如何将 WAI-ARIA 角色映射到平台 可访问性 API。

在计算可访问名称或可访问描述时，用户代理 MUST 符合可访问名称和描述规范 [ACCNAME-AAM] 中标题为 文本替代 计算一节的要求，并针对 SVG 宿主语言作出以下 修改：

1. 将 隐藏且未被引用： 替换为以下内容：

   如果当前节点遍历不是由跟随 aria-labelledby 或 aria-describedby 引用而产生，并且当前节点 根据 从可访问性树中排除元素 和 将元素纳入可访问性树中的规则未被纳入 可访问性树，则返回空字符串。

2. 将 步骤 2D 替换为 以下内容：

   否则，如果正在为可访问名称执行文本替代计算：

   • 如果当前节点至少有一个直接子 title 元素，则根据 SVG 规范的语言规则选择 适当的 title，并将 title 文本替代作为扁平字符串返回。
   • 如果当前节点是链接，并且没有子 title 元素，但它具有 xlink:title 属性，则返回该属性的值。

   如果正在为可访问描述执行文本替代计算：

   • 如果当前节点至少有一个直接子 desc 元素，则根据 SVG 规范的语言规则选择 适当的描述，并返回该描述的拼接文本内容。

3. 在 步骤 2F 中，通过将 步骤 iii 中的：

   对于当前节点的每个子节点：

   替换为：

   如果该元素是文本容器元素，则对于当前节点的每个子节点：

   来修改该步骤
4. 将 步骤 2H 替换为 以下内容：

   否则，如果正在为可访问描述执行文本替代计算，并且 当前节点至少有一个直接子 title 元素，但在为该节点生成 可访问名称时未使用 title 元素，则根据 SVG 规范的语言规则选择适当的 title，并返回 title 文本内容作为描述。

   否则，如果当前节点是链接，并且它具有未用于可访问名称的 xlink:title 属性，则返回该属性的值。

在确定某个元素是否具有直接子元素时，只考虑实际的 DOM 子元素，而不管父元素是否具有关联的 影子树。

SVG 用户代理 MUST 符合 核心可访问性 API 映射 [CORE-AAM] 中 控件值 的可访问性 API 计算要求。

SVG 用户代理 MUST 符合 核心可访问性 API 映射 [CORE-AAM] 中 关系 的可访问性 API 计算要求。

SVG 用户代理 MUST 符合 核心可访问性 API 映射 [CORE-AAM] 中 组 位置 的可访问性 API 计算要求。

本规范使用 影子树 和 宿主 这两个由 DOM 标准 [DOM] 定义的术语，以及 use 元素影子树 和 元素实例 这两个由 SVG 2 [SVG2] 定义的术语。

SVG 用户代理 MUST 处理为 use 元素影子树生成的元素实例，就像这些元素是 use 元素自身的子元素一样，并满足以下 条件：

• 在处理影子树内元素上的 WAI-ARIA 属性时， 用户代理 MUST 首先尝试将任何 IDREF 值与同一影子树中的 其他元素匹配，然后再 在宿主的节点树中搜索匹配项。如果影子树发生嵌套，用户代理 MUST 从当前影子树递归搜索到包含其宿主 use 元素的树，直到到达文档树。

• 在所有其他情况下，当匹配 WAI-ARIA 属性中的 IDREF 值时，用户代理 MUST NOT 考虑 use 元素影子树中的元素。

SVG 为作者提供了指定文档某个特定 视图的方法。视图通过文档 URL 的目标片段应用，可以是引用 view 元素的 id，也可以是 使用 SVG 视图规范片段标识符 指定自定义视图。

SVG 视图的视觉效果等同于修改父 svg 元素（对于 view 元素）或根元素（对于 SVG 视图 规范片段）上的属性。因此，用户代理 SHOULD 在视图生效时修改表示该 svg 的可访问对象。

具体而言，应作出以下变更：

• 如果该视图包含 viewTarget 属性，则 svg 元素 SHOULD 被映射为如同其具有 aria-flowto 属性， 且该属性指定与 viewTarget 属性中包含的 IDREF 值相同的列表。
• 如果该视图是使用 view 元素应用的，则计算该元素的可访问名称和 描述，忽略 view 元素被排除在 可访问性树之外这一事实。如果结果是非空字符串，则在视图生效期间，它 SHOULD 替换 svg 元素对应的名称或描述。

指向包含 SVG 视图 规范或 view 元素 id 的 URL 的导航动作 SHOULD 被视为目标 svg 元素上的一系列属性变更 事件，随后导航到该元素。用户代理 MAY 将属性变更表示为删除现有 节点后再插入已修改节点。

SVG 动画元素可以修改元素属性和 样式属性。CSS 动画可以修改样式 属性。这两种动画都可以由用户交互触发，或 按固定计划运行。

如果动画改变了 WAI-ARIA 状态或属性特性的有效值，或改变了 状态和属性映射一节中描述的 SVG 属性，则用户代理 MUST 以与实际属性值被 更改时相同的方式暴露该变更。

如果动画变更影响某个元素是否被渲染，或以会导致其从可访问性树中排除的方式 改变其可见性，则用户代理 SHOULD 按照核心可访问性 API 映射 [CORE-AAM] 中 文档内容或节点可见性 的变更一节的指南暴露该变更。