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="text" /> <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()