CKTIS / JavaScript
HTMLElement.innerHTML: leggere e sostituire il contenuto di un elemento
Leggere `innerHTML` restituisce il markup del contenuto di un elemento. Assegnare un valore sostituisce il contenuto con i nodi prodotti dal parser, anche con `+=`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""HTMLElement.innerHTML è una proprietà di istanza ereditata da Element, non un metodo statico. La lettura restituisce il contenuto attuale del DOM come stringa, senza i tag dell’elemento stesso né le radici dello Shadow DOM. È una serializzazione dell’albero, non una copia del testo sorgente.
L’assegnazione analizza il markup nel contesto dell’elemento e ne sostituisce i nodi figli, senza sostituire l’elemento stesso. Per template sostituisce il contenuto di template.content. Il setter accetta una stringa o TrustedHTML. Web IDL converte null nella stringa vuota ("") prima del controllo di Trusted Types. Se la stringa arriva al parser senza modifiche, il contenuto viene svuotato. Quando Trusted Types è obbligatorio, però, una policy predefinita può trasformare la stringa vuota in markup non vuoto: il fatto che l’assegnazione riesca non garantisce che il contenuto venga svuotato. Il setter non crea radici dichiarative dello Shadow DOM.
element.innerHTML += markup legge il markup serializzato, concatena il nuovo testo e analizza nuovamente l’intero risultato. I vecchi nodi vengono scollegati e i listener di eventi registrati direttamente su di essi non vengono trasferiti ai nuovi nodi. Per conservare i nodi esistenti, aggiungi quelli nuovi con append().
Non passare input non attendibile direttamente a innerHTML: per impostazione predefinita non lo sanifica e gli attributi dei gestori di eventi possono causare XSS, anche se gli elementi script inseriti non vengono eseguiti. Usa textContent per il testo semplice e uno strumento di sanificazione verificato se serve HTML. Una policy Trusted Types non garantisce da sola la sanificazione.
Questa API appartiene alla piattaforma web, non a ECMAScript 2024. Il supporto per Trusted Types varia a seconda dell’ambiente. Se la CSP impone Trusted Types e manca una policy predefinita, assegnare una stringa genera TypeError. Il parser HTML recupera dagli errori di sintassi, ma in un documento XML un frammento non ben formato può generare SyntaxError durante l’assegnazione. Se il contenuto non può essere serializzato come XML ben formato, la lettura può generare InvalidStateError.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML example</title>
</head>
<body>
<script>
const box = document.createElement("div");
box.innerHTML = "<strong>Hello</strong>";
const original = box.firstElementChild;
box.innerHTML += "<em> again</em>";
console.log(box.innerHTML);
console.log(box.textContent);
console.log(original === box.firstElementChild);
console.log(original.parentNode === null);
</script>
</body>
</html>Risultato
<strong>Hello</strong><em> again</em> Hello again false true
Salva l’esempio come file HTML, aprilo in un browser senza imporre Trusted Types e controlla la console per sviluppatori. Le prime due righe confrontano markup e testo; le ultime due mostrano che il primo nodo è stato sostituito e non ha più un genitore.
Lezioni correlate
- JavaScript · Lezione 31 · Avanzato · Versione: 4