ElementInternals: ariaHidden 属性
ElementInternals 接口的 ariaHidden 属性反映了 aria-hidden 属性的值,该属性指示元素是否对可访问性 API 可见。
注意:在 ElementInternals 上设置 ARIA 属性允许为自定义元素定义默认语义。这些默认语义可能会被作者定义的属性覆盖,但可以确保在作者删除或根本未添加这些属性时,默认语义仍然保留。有关更多信息,请参阅 Accessibility Object Model explainer。
值
一个字符串,其值可能为以下之一:
"true"-
元素被隐藏,不向辅助功能 API 公开。
"false"-
该元素将像渲染一样对可访问性 API 可见。
"undefined"-
元素的隐藏状态由用户代理根据其是否渲染来决定。
示例
在此示例中,ariaHidden 的值设置为“true”。
js
class CustomControl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaHidden = "true";
}
// …
}
规范
| 规范 |
|---|
| 无障碍富互联网应用程序 (WAI-ARIA) # dom-ariamixin-ariahidden |
浏览器兼容性
加载中…