Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti