Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.removeAttribute — rimuovere un attributo

Element.removeAttribute rimuove un attributo di un elemento in base al nome. Restituisce undefined; se l’attributo non esiste, non si verifica alcun errore.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

element.removeAttribute(qualifiedName)

Element.removeAttribute rimuove il primo attributo dell’elemento il cui nome qualificato corrisponde al nome cercato. È un metodo del DOM, non una funzione di ECMAScript stesso.

Se l’elemento appartiene allo spazio dei nomi HTML e il documento a cui appartiene è un documento HTML, il metodo converte le lettere maiuscole ASCII (A–Z) di qualifiedName in minuscole prima di cercare l’attributo. Ad esempio, removeAttribute('DATA-STATE') può rimuovere l’attributo data-state. Negli altri casi il metodo usa l’argomento senza modificarne le maiuscole o le minuscole.

La chiamata element.removeAttribute(qualifiedName) restituisce undefined, non il valore rimosso. Se non ci sono attributi corrispondenti, non cambia nulla. Attributi in spazi dei nomi diversi possono avere lo stesso nome qualificato. Una singola chiamata rimuove solo il primo attributo corrispondente. Se rimane un altro attributo corrispondente, hasAttribute(qualifiedName) restituisce true e getAttribute(qualifiedName) restituisce il valore del primo attributo corrispondente ancora presente. Se non ne rimane nessuno, questi metodi restituiscono rispettivamente false e null.

Rimuovere un attributo è diverso dall’impostare una stringa vuota con setAttribute: un attributo vuoto esiste comunque. Il metodo non rimuove l’elemento stesso. Per indicare un attributo tramite spazio dei nomi e nome locale, usa removeAttributeNS(namespace, localName).

Esempi

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'));

Risultato

ready
false
null
undefined
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti