JavaScript метод Element.setAttribute()

Определение и применение

JavaScript метод setAttribute() объекта Element позволяет добавить новый атрибут, или значение атрибута с указанным именем текущему элементу.

Для того, чтобы удалить из элемента атрибут с указанным именем, воспользуйтесь методом JavaScript removeAttribute() объекта Element. Пример вы можете найти внизу страницы.

Поддержка браузерами

Спецификация: dom.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Отдельные значения (2) поддерживаются не везде — смотрите таблицу.

Показать браузеры
Совместимостьapi.Element.setAttribute
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
setAttribute✓1✓12✓1✓8✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1
Requires value parameter to be TrustedHTML instance (for iframe.srcdoc), or TrustedScriptURL (for HTML script.src, and SVG script.href) when trusted types are enforced✓83✓83✓preview✓69✓26✓83×✓59✓26✓13.0✓83✓26
Emoji and more Unicode in element and attribute names and namespace prefix (valid names match HTML parser)✓143✓143✓149✓127×✓143✓149✓94×✓30.0✓143×

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
element.setAttribute(attributeName, value);

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

DOM Standard.

Значения параметров

Параметры Element.setAttribute()
Параметр Описание
attributeName Имя атрибута, значение которого вы хотите изменить, или новый атрибут с указанным значением. Обязательный параметр.
value Значение, которое будет присвоено атрибуту. Любое указанное не строковое значение автоматически преобразуется в строку. Обязательный параметр.

Исключения

Тип исключения Описание — Element.setAttribute()
Тип исключения Описание
InvalidCharacterError Возникает в том случае, если указанное имя атрибута содержит один или несколько символов, которые недопустимы в именах атрибутов.

Пример использования

Чтение и увеличение значения атрибута data-val

Нажмите ▶, затем Click me несколько раз: в абзаце появляется текущее значение data-val, после чего setAttribute() записывает в атрибут значение, увеличенное на единицу.

index.html
HTML
<button data-migration-click-0="">Click me</button>
<p data-val="1"></p>
main.js
JavaScript
const checkAttr = function () {
    const p = document.querySelector('p'),
        attr = 'data-val'

    if (p.hasAttribute(attr)) {
        const attrVal = p.getAttribute(attr)
        p.innerHTML = attrVal

        const newAttrVal = Number(attrVal) + 1
        p.setAttribute(attr, newAttrVal)
    }
}

// Обработчики кнопок перенесены из HTML для запуска с CSP без inline-скриптов.
document.querySelector('[data-migration-click-0]').addEventListener('click', function () {
    checkAttr()
})
document.querySelector('[data-migration-click-0]').removeAttribute('data-migration-click-0')

В этом примере с использованием метода addEventListener() при нажатии на кнопку (HTML элемент <button>) вызываем функцию, которая:

  • Инициализирует две переменные, первая переменная содержит первый элемент <p> в документе, а вторая строковое значение (одноименное с атрибутом элемента <p>).
  • С помощью метода hasAttribute() проверяем имеется ли у элемента <p> атрибут со значением, содержащимся в переменной attr.
  • С помощью метода getAttribute() получаем значение этого атрибута и с помощью свойства innerHTML добавляем элементу <p> новое содержимое (значение атрибута data-val).
  • После этого инициализируем переменную, которая увеличивает значение атрибута data-val на 1, и с помощью метода setAttribute() устанавливаем новое значение для атрибута data-val элементу <p>. Обратите внимание, что перед увеличением на единицу мы приводим строковое значение, содержащееся в переменной к числу, используя конструктор Number().

В следующем примере мы рассмотрим как произвести удаление конкретного атрибута у элемента с использованием метода removeAttribute():

Добавление и удаление атрибута style

Нажмите ▶, затем Set attribute: текст абзаца станет красным. Remove attribute удалит атрибут style, и цвет вернётся к исходному.

index.html
HTML
<button data-migration-click-0="">Set attribute</button>
<button data-migration-click-2="">Remove attribute</button>
<p>Съешь ещё этих мягких французских булок, да выпей же чаю.</p>
main.js
JavaScript
const p = document.querySelector('p')

const setAttr = function () {
    p.setAttribute('style', 'color:red')
}
const removeAttr = function () {
    p.removeAttribute('style')
}

// Обработчики кнопок перенесены из HTML для запуска с CSP без inline-скриптов.
document.querySelector('[data-migration-click-0]').addEventListener('click', function () {
    setAttr()
})
document.querySelector('[data-migration-click-0]').removeAttribute('data-migration-click-0')
document.querySelector('[data-migration-click-2]').addEventListener('click', function () {
    removeAttr()
})
document.querySelector('[data-migration-click-2]').removeAttribute('data-migration-click-2')

В этом примере с использованием метода addEventListener() при нажатии на первую кнопку (HTML элемент <button>) мы вызываем функцию, которая с помощью метода setAttribute() устанавливает значение глобального атрибута style у элемента <p>, который мы предварительно выбрали с использованием метода querySelector().

При нажатии на вторую кнопку мы вызываем функцию, которая с помощью метода removeAttribute() удаляет атрибут style у элемента <p>.