Element:ariaDetailsElements 属性
>Element 接口的 ariaDetailsElements 属性是一个数组,包含为应用了该属性的元素提供无障碍详情的元素(一个或多个)。无障碍详情类似于无障碍描述(参见 ariaDescribedByElements),但提供更详细的信息。
aria-details 主题包含关于应当如何使用该特性和属性的更多信息。
值
一个由 HTMLElement 的子类组成的数组。这些元素的内部文本可以用空格连接起来,构成无障碍详情。
读取时,返回的数组是静态的且只读。写入时,所赋值的数组会被复制:之后对该数组的更改不会影响属性的值。
描述
该属性是使用 aria-details 特性设置无障碍详情信息的一种灵活替代方案。与 aria-details 不同的是,分配给此属性的元素不必具有 id 属性。
当定义了元素的 aria-details 特性时,该属性会反映这个特性,但仅限与有效作用域内元素匹配的已列出的引用 id 值。如果设置了该属性,则相应的特性会被清除。有关反射元素引用和作用域的更多信息,请参见反射特性指南中的反射的元素引用。
示例
>获取无障碍详情
此示例演示如何使用 ariaDetailsElements 获取在 HTML 中使用 aria-details 特性定义的信息。
HTML
HTML 定义了两个 <span> 元素,并在一个 <button> 的 aria-details 特性中引用它们的 id。
<button aria-details="details1 details2">按钮文本</button>
…
<span id="details1">有关此元素的详情 1 信息。</span>
<span id="details2">有关此元素的详情 2 信息。</span>
JavaScript
下面的代码首先使用 Element.getAttribute() 记录 aria-details 特性的值(一个列出所引用元素 id 值的字符串)。然后检查是否支持 ariaDetailsElements 属性,如果支持,则记录其值。最后返回无障碍字符串,该字符串通过遍历返回的元素并拼接它们的内部文本计算得出。
const buttonElement = document.querySelector("button");
log(`aria-details: ${buttonElement.getAttribute("aria-details")}`);
// 特性检测:ariaDetailsElements
if ("ariaDetailsElements" in Element.prototype) {
// 获取 ariaDetailsElements
const buttonElements = buttonElement.ariaDetailsElements;
log(`ariaDetailsElements: ${buttonElements}`);
// 从 ariaDetailsElements 获取无障碍详情
const text = buttonElements.map((e) => e.textContent.trim()).join(" ");
log(`无障碍详情:${text.trim()}`);
} else {
log("element.ariaDetailsElements:浏览器不支持");
}
结果
下方的日志显示了原始的元素引用、关联/返回的元素,以及无障碍详情。
规范
| 规范 |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # dom-ariamixin-ariadetailselements> |