Элемент: метод toggleAttribute()

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Метод toggleAttribute() интерфейса Element переключает булево атрибут (удаляя его, если он присутствует, и добавляя его, если он отсутствует) для данного элемента.

Синтаксис

toggleAttribute(name)
toggleAttribute(name, force)

Параметры

name

Строка, определяющая имя атрибута, который нужно переключить. Имя атрибута автоматически преобразуется в нижний регистр, когда метод toggleAttribute() вызывается для HTML-элемента в HTML-документе.

force Необязательно

Булево значение, которое имеет следующие эффекты:

если не указано, метод toggleAttribute "переключает" атрибут с именем name — удаляет его, если он присутствует, или добавляет его, если он отсутствует
если true, метод toggleAttribute добавляет атрибут с именем name
если false, метод toggleAttribute удаляет атрибут с именем name

Возвращаемое значение

true если атрибут name в итоге присутствует, и false в противном случае.

Исключения

InvalidCharacterError DOMException: Указанный атрибут name содержит один или несколько символов, которые не являются допустимыми в именах атрибутов.

Примеры

В следующем примере используется toggleAttribute() для переключения атрибута disabled для элемента <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");
});

Результат

Спецификации

Спецификация
DOM # ref-for-dom-element-toggleattribute①

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`toggleAttribute`	69	18	63	56	12	69	63	48	12	10.0	69

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/toggleAttribute