CKTIS / JavaScript
Element.setAttribute — impostare un attributo
Element.setAttribute accetta il nome e il valore di un attributo di un elemento del DOM. Se la chiamata riesce, aggiunge l’attributo o ne sostituisce il valore.
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.setAttribute(qualifiedName, value)Se la chiamata a element.setAttribute(qualifiedName, value) riesce, il metodo crea l’attributo se manca oppure aggiorna il primo attributo con quel nome. È un metodo del DOM, non una funzione di ECMAScript stesso.
Quando la politica di sicurezza dei contenuti (CSP) impone l’uso di Trusted Types, passare una semplice stringa come valore di un attributo protetto come onclick può generare un’eccezione TypeError senza che l’attributo venga creato o aggiornato.
Per gli elementi nello spazio dei nomi HTML che appartengono a un documento HTML, il nome viene convertito in minuscolo ASCII. Un nome non valido genera una DOMException di tipo InvalidCharacterError. Usa setAttributeNS per impostare attributi con uno spazio dei nomi specificato.
Esempi
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Risultato
ready
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. L’esempio con `data-state` non mostra gli effetti dell’obbligo di usare Trusted Types su un attributo protetto.