Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.removeAttribute — usuwanie atrybutu

Element.removeAttribute usuwa atrybut elementu według nazwy. Zwraca undefined; brak wskazanego atrybutu nie powoduje błędu.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

element.removeAttribute(qualifiedName)

Element.removeAttribute usuwa z elementu pierwszy atrybut o pasującej nazwie kwalifikowanej. Jest to metoda DOM, a nie funkcja samego ECMAScript.

Jeśli element należy do przestrzeni nazw HTML, a dokument, do którego należy, jest dokumentem HTML, metoda przed wyszukaniem atrybutu zamienia wielkie litery ASCII (A–Z) w argumencie qualifiedName na małe. Na przykład removeAttribute('DATA-STATE') może usunąć atrybut data-state. W pozostałych przypadkach metoda używa argumentu bez zmiany wielkości liter.

Wywołanie element.removeAttribute(qualifiedName) zwraca undefined, nie usuniętą wartość. Gdy nie ma pasującego atrybutu, wywołanie niczego nie zmienia. Atrybuty z różnych przestrzeni nazw mogą mieć tę samą nazwę kwalifikowaną. Jedno wywołanie usuwa tylko pierwszy pasujący atrybut. Jeśli pozostanie inny pasujący atrybut, hasAttribute(qualifiedName) zwróci true, a getAttribute(qualifiedName) zwróci wartość pierwszego z pozostałych pasujących atrybutów. Jeśli nie pozostanie żaden pasujący atrybut, metody te zwrócą odpowiednio false i null.

Usunięcie atrybutu różni się od ustawienia pustego tekstu przez setAttribute: pusty atrybut nadal istnieje. Metoda nie usuwa samego elementu. Aby wskazać atrybut przez przestrzeń nazw i nazwę lokalną, użyj removeAttributeNS(namespace, localName).

Przykłady

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

Wynik

ready
false
null
undefined
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła