Element:toggleAttribute() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

语法

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="文本" /> <button>toggleAttribute("disabled")</button>

JavaScript

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

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

结果

规范

Specification
DOM Standard
# ref-for-dom-element-toggleattribute①

浏览器兼容性

BCD tables only load in the browser

参见