Element: toggleAttribute() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
Thuộc tính toggleAttribute() của giao diện Element toggles a Boolean attribute on the given element, removing it if present and adding it if not present.
Cú pháp
toggleAttribute(name)
toggleAttribute(name, force)
Tham số
name-
Một chuỗi specifying the name of the attribute to be toggled. The attribute name is automatically converted to all lower-case when
toggleAttribute()is called on an HTML element in an HTML document. forceOptional-
Một boolean value which has the following effects:
- if not specified at all, the
toggleAttributemethod "toggles" the attribute namedname— removing it if it is present, or else adding it if it is not present - if true, the
toggleAttributemethod adds an attribute namedname - if false, the
toggleAttributemethod removes the attribute namedname
- if not specified at all, the
Giá trị trả về
true if attribute name is eventually
present, and false otherwise.
Ngoại lệ
InvalidCharacterErrorDOMException-
The specified attribute
namechứa one or more characters that are not valid in attribute names. Thenamemust have at least one character, and may not contain ASCII whitespace,NULL,/,=or>(U+0000, U+002F, U+003D, or U+003E, respectively).
Ví dụ
>Basic usage
Trong ví dụ sau, toggleAttribute() is used to toggle the disabled attribute of an <input>.
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");
});
Result
Đặc tả kỹ thuật
| Specification |
|---|
| DOM> # ref-for-dom-element-toggleattribute①> |