KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen