此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:ariaExpanded 属性

基线
广泛可用

自 2023年10月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Element 接口的 ariaExpanded 属性反映 aria-expanded 属性的值,该属性指示由此元素拥有或控制的分组元素处于展开还是折叠状态。

值

一个具有以下值之一的字符串:

"true"

此元素拥有或控制的分组元素处于展开状态。

"false"

此元素拥有或控制的分组元素处于折叠状态。

"undefined"

该元素不拥有或不控制可展开的分组元素。

示例

在这个示例中,ID 为 animal 的元素上的 aria-expanded 属性被设置为“false”。我们使用 ariaExpanded 将值更新为“true”。

html
<div class="animals-combobox">
  <label for="animal">动物</label>
  <input
    id="animal"
    type="text"
    role="combobox"
    aria-autocomplete="list"
    aria-expanded="false"
    aria-haspopup="true" />
  <button id="animals-button" tabindex="-1" aria-label="展开">▽</button>
  <ul id="animals-listbox" role="listbox" aria-label="动物列表">
    <li id="animal-cat" role="option">猫</li>
    <li id="animal-dog" role="option">狗</li>
  </ul>
</div>
js
let el = document.getElementById("animal");
console.log(el.ariaExpanded); // false
el.ariaExpanded = "true";
console.log(el.ariaExpanded); // true

规范

规范
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariaexpanded

浏览器兼容性