元素：ariaExpanded 属性

基线 2023

新可用

自 2023 年 10 月起，此功能可在最新的设备和浏览器版本中使用。此功能可能在较旧的设备或浏览器中无法使用。

ariaExpanded 是 Element 接口的一个属性，它反映了 aria-expanded 属性的值，该属性指示此元素拥有或控制的组合元素是展开还是折叠。

值

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

"true": 此元素拥有或控制的组合元素已展开。
"false": 此元素拥有或控制的组合元素已折叠。
"undefined": 该元素不拥有或控制可扩展的组合元素。

示例

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

html

<div class="animals-combobox">
  <label for="animal">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="Open">▽</button>
  <ul id="animals-listbox" role="listbox" aria-label="Animals">
    <li id="animal-cat" role="option">Cat</li>
    <li id="animal-dog" role="option">Dog</li>
  </ul>
</div>

let el = document.getElementById("animal");
console.log(el.ariaExpanded); // false
el.ariaExpanded = "true";
console.log(el.ariaExpanded); // true

规范

规范
无障碍富互联网应用程序 (WAI-ARIA) # dom-ariamixin-ariaexpanded

浏览器兼容性

BCD 表格仅在浏览器中加载