DOM
Element 接口的 toggleAttribute() 方法翻转给定元素的某个布尔属性的状态(如果属性存在则移除,属性不存在则添加)。
语法
toggleAttribute(name)
toggleAttribute(name, force)
参数
name- : 一个指定要翻转的属性的名称的字符串。当在 HTML 文档中的 HTML 元素上调用
toggleAttribute()时,属性名会自动转换为全小写形式。
- : 一个指定要翻转的属性的名称的字符串。当在 HTML 文档中的 HTML 元素上调用
force- : 一个具有以下效果的布尔值:
- 如果根本没有指定,
toggleAttribute方法会“翻转”名为name的属性——如果属性存在则移除,或者如果属性不存在则添加。 - 如果为 true,
toggleAttribute方法则会添加一个名为name的属性。 - 如果为 false,
toggleAttribute方法则会移除名为name的属性。
- 如果根本没有指定,
- : 一个具有以下效果的布尔值:
返回值
如果属性的名称(name)最终存在,则返回 true,否则返回 false。
异常
InvalidCharacterErrorDOMException- : 指定属性名称(
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。离线整理了版式、链接和媒体显示。
