Movatterモバイル変換


[0]ホーム

URL:


  1. 面向开发者的 Web 技术
  2. Web API
  3. Element
  4. Element:toggleAttribute() 方法

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in EnglishAlways switch to English

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 2018年10月.

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

语法

js
toggleAttribute(name)toggleAttribute(name, force)

参数

name

一个指定要翻转的属性的名称的字符串。当在 HTML 文档中的 HTML 元素上调用toggleAttribute() 时,属性名会自动转换为全小写形式。

force可选

一个具有以下效果的布尔值:

  • 如果根本没有指定,toggleAttribute 方法会“翻转”名为name 的属性——如果属性存在则移除,或者如果属性不存在则添加。
  • 如果为 true,toggleAttribute 方法则会添加一个名为name 的属性。
  • 如果为 false,toggleAttribute 方法则会移除名为name 的属性。

返回值

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

异常

InvalidCharacterErrorDOMException

指定属性名称(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
# ref-for-dom-element-toggleattribute①

浏览器兼容性

参见

Help improve MDN

Learn how to contribute

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2026 Movatter.jp