元素：toggleAttribute() 方法

toggleAttribute() 是 Element 接口的一个方法，用于切换给定元素上的布尔属性（如果存在则移除，如果不存在则添加）。

语法

js
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

html
<input value="text" /> <button>toggleAttribute("disabled")</button>

JavaScript

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

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

结果

规范

规范
DOM 标准
# ref-for-dom-element-toggleattribute①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅