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

Element:toggleAttribute() 方法

· 52CE 我爱测

Element 接口的 **`toggleAttribute()`** 方法翻转给定元素的某个布尔属性的状态(如果属性存在则移除,属性不存在则添加)。

DOM

Element 接口的 toggleAttribute() 方法翻转给定元素的某个布尔属性的状态(如果属性存在则移除,属性不存在则添加)。

语法

toggleAttribute(name)
toggleAttribute(name, force)

参数

  • name
    • : 一个指定要翻转的属性的名称的字符串。当在 HTML 文档中的 HTML 元素上调用 toggleAttribute() 时,属性名会自动转换为全小写形式。
  • force
    • : 一个具有以下效果的布尔值:
      • 如果根本没有指定,toggleAttribute 方法会“翻转”名为 name 的属性——如果属性存在则移除,或者如果属性不存在则添加。
      • 如果为 true,toggleAttribute 方法则会添加一个名为 name 的属性。
      • 如果为 false,toggleAttribute 方法则会移除名为 name 的属性。

返回值

如果属性的名称(name)最终存在,则返回 true,否则返回 false。

异常

  • InvalidCharacterError DOMException
    • : 指定属性名称(name)包含一个或多个在属性名称中无效的字符。

示例

在下面的例子中,toggleAttribute() 被用于切换 input 的 disabled 属性。

HTML

<input value="文本" /> <button>toggleAttribute("disabled")</button>

JavaScript

const button = document.querySelector("button");
const input = document.querySelector("input");

button.addEventListener("click", () => {
  input.toggleAttribute("disabled");
});

结果

示例

规范

浏览器兼容性

参见

  • Element.hasAttribute()
  • Element.getAttribute()
  • Element.removeAttribute()
  • Element.setAttribute()

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

资料来源与适用范围

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

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

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