CKTIS / JavaScript
Element.removeAttribute — een attribuut verwijderen
Element.removeAttribute verwijdert een attribuut van een element op basis van de naam. De methode geeft undefined terug; een ontbrekend attribuut veroorzaakt geen fout.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.removeAttribute(qualifiedName)Element.removeAttribute verwijdert het eerste attribuut van het element met een overeenkomende gekwalificeerde naam. Dit is een DOM-methode, geen functie van ECMAScript zelf.
Als het element tot de HTML-naamruimte behoort en het document waartoe het behoort een HTML-document is, zet de methode de ASCII-hoofdletters (A–Z) in qualifiedName om in kleine letters voordat ze het attribuut opzoekt. Zo kan removeAttribute('DATA-STATE') het attribuut data-state verwijderen. In andere gevallen gebruikt de methode het argument zonder hoofdletters of kleine letters te wijzigen.
De aanroep element.removeAttribute(qualifiedName) geeft undefined terug, niet de verwijderde waarde. Als er geen overeenkomend attribuut is, verandert er niets. Attributen in verschillende naamruimten kunnen dezelfde gekwalificeerde naam hebben. Eén aanroep verwijdert alleen het eerste overeenkomende attribuut. Als er nog een overeenkomend attribuut is, geeft hasAttribute(qualifiedName) true terug en geeft getAttribute(qualifiedName) de waarde van het eerste overgebleven overeenkomende attribuut terug. Als er geen overeenkomend attribuut meer is, geven deze methoden respectievelijk false en null terug.
Een attribuut verwijderen is iets anders dan met setAttribute een lege tekenreeks instellen: een leeg attribuut bestaat nog steeds. De methode verwijdert het element zelf niet. Gebruik removeAttributeNS(namespace, localName) om een attribuut aan te duiden met de naamruimte en lokale naam.
Voorbeelden
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'));Resultaat
ready false null undefined false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.