DOM
The toggleAttribute() method of the ProcessingInstruction interface toggles a boolean attribute on the given processing instruction, removing it if present and adding it if not present.
Syntax
toggleAttribute(name)
toggleAttribute(name, force)
Parameters
name- : A string specifying the name of the attribute to be toggled.
force- : A boolean value that has the following effects:
- If not specified at all, the attribute is removed if it is present and added if it is not present.
- If set to
true, the attribute is added if it is not present, but it isn't removed if it is present. - If set to
false, the attribute is removed if it is present, but it isn't added if it is not present.
- : A boolean value that has the following effects:
Return value
true if the attribute is present after the toggleAttribute() operation completes, and false if not.
Exceptions
InvalidCharacterErrorDOMException- : The specified attribute
namecontains 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).
- : The specified attribute
Examples
Basic usage
const pi = document.createProcessingInstruction("start", 'name=""');
pi.toggleAttribute("name");
pi.toggleAttribute("surname");
console.log(pi);
// logs:
// <?start surname=""?>
Specifications
Browser compatibility
See also
- ProcessingInstruction.hasAttribute()
- ProcessingInstruction.hasAttributes()
- ProcessingInstruction.getAttribute()
- ProcessingInstruction.getAttributeNames()
- ProcessingInstruction.setAttribute()
- ProcessingInstruction.removeAttribute()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
