База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Element.setAttribute — задаване на атрибут

Element.setAttribute приема име и стойност на атрибут на DOM елемент. При успешно извикване методът добавя атрибута или заменя стойността му.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

element.setAttribute(qualifiedName, value)

При успешно извикване element.setAttribute(qualifiedName, value) създава липсващ атрибут или актуализира първия атрибут с това име. Това е метод на DOM, а не функция на самия ECMAScript.

Когато политиката за сигурност на съдържанието (CSP) изисква използването на Trusted Types, подаването на обикновен низ като стойност на защитен атрибут, например onclick, може да предизвика изключение TypeError, без атрибутът да бъде създаден или актуализиран.

За елементи в пространството от имена HTML, които принадлежат към HTML документ, името се преобразува в малки букви от ASCII. Невалидно име предизвиква DOMException от тип InvalidCharacterError. Използвайте setAttributeNS, за да задавате атрибути с определено пространство от имена.

Примери

const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));

Резултат

ready

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия. Примерът с `data-state` не показва как задължителното използване на Trusted Types влияе върху защитен атрибут.

Източници