Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje