大网数据广告活动
Web 标准与前端开发

Element:ariaExpanded 属性

· 52CE 我爱测

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

DOM

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

值

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

  • "true"
    • : 此元素拥有或控制的分组元素处于展开状态。
  • "false"
    • : 此元素拥有或控制的分组元素处于折叠状态。
  • "undefined"
    • : 该元素不拥有或不控制可展开的分组元素。

示例

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

<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>
let el = document.getElementById("animal");
console.log(el.ariaExpanded); // false
el.ariaExpanded = "true";
console.log(el.ariaExpanded); // true

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。