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.