CKTIS / JavaScript
Element.removeAttribute — odstranění atributu
Element.removeAttribute odstraní atribut prvku podle jeho názvu. Vrací undefined; chybějící atribut nezpůsobí chybu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.removeAttribute(qualifiedName)Element.removeAttribute odstraní první atribut prvku, jehož kvalifikovaný název odpovídá hledanému názvu. Jde o metodu DOM, nikoli o funkci samotného ECMAScriptu.
Pokud prvek patří do jmenného prostoru HTML a dokument, k němuž prvek náleží, je dokumentem HTML, metoda před vyhledáním atributu převede velká písmena ASCII (A–Z) v argumentu qualifiedName na malá. Například removeAttribute('DATA-STATE') může odstranit atribut data-state. V ostatních případech metoda použije argument beze změny velikosti písmen.
Volání element.removeAttribute(qualifiedName) vrací undefined, nikoli odstraněnou hodnotu. Pokud žádný atribut neodpovídá, nic se nezmění. Atributy v různých jmenných prostorech mohou mít stejný kvalifikovaný název. Jedno volání odstraní pouze první odpovídající atribut. Pokud zůstane další odpovídající atribut, hasAttribute(qualifiedName) vrátí true a getAttribute(qualifiedName) vrátí hodnotu prvního ze zbývajících odpovídajících atributů. Pokud žádný odpovídající atribut nezůstane, hasAttribute(qualifiedName) vrátí false a getAttribute(qualifiedName) vrátí null.
Odstranění atributu se liší od nastavení prázdného řetězce pomocí setAttribute: prázdný atribut stále existuje. Metoda neodstraňuje samotný prvek. Chceš-li určit atribut pomocí jmenného prostoru a místního názvu, použij removeAttributeNS(namespace, localName).
Příklady
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'));Výsledek
ready false null undefined false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.