CKTIS / JavaScript
Element.innerHTML e Element.className
Usa `innerHTML` per leggere o sostituire il contenuto di un elemento e `className` per leggere o impostare le sue classi CSS.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML e className sono due proprietà di istanza del DOM, non metodi. Appartengono alla piattaforma web, non a ECMAScript 2024: un ambiente JavaScript privo di DOM non le fornisce.
In lettura, element.innerHTML serializza il contenuto attuale in una stringa, senza includere i tag dell’elemento stesso né le radici dello shadow DOM. L’assegnazione analizza un frammento come HTML o XML a seconda del documento e sostituisce i nodi figli, non l’elemento stesso. Anche un markup identico crea nodi nuovi: i vecchi riferimenti puntano ancora ai nodi rimossi e i loro listener non vengono trasferiti. Per un template, l’assegnazione sostituisce i nodi figli del DocumentFragment restituito da content, non il frammento stesso. Assegnare null equivale ad assegnare "". In un documento XML, un frammento non ben formato genera SyntaxError e un errore di serializzazione può generare InvalidStateError; entrambi sono nomi di DOMException.
Per un elemento HTML, element.className rispecchia l’attributo class come unica stringa di nomi separati da spazi bianchi. L’assegnazione sostituisce l’intero valore dell’attributo senza cambiare i nodi figli. Per modificare una sola classe mantenendo le altre, usa classList.add(), classList.remove() o classList.toggle(). In SVG className può essere un SVGAnimatedString: per leggere o scrivere l’intero attributo usa invece getAttribute("class") o setAttribute("class", value). getAttribute() restituisce null se l’attributo è assente e "" se è presente ma vuoto.
Per impostazione predefinita innerHTML non sanifica l’input: non assegnargli direttamente dati non attendibili, perché possono causare attacchi di cross-site scripting (XSS). Per inserire testo semplice in un elemento comune, usa textContent: il testo non viene interpretato come HTML. Se serve markup proveniente da una fonte non attendibile, sanificalo prima. Dove Trusted Types è supportato, una policy può restituire contenuto sanificato come TrustedHTML; il tipo in sé non sanifica nulla. Se la CSP impone Trusted Types e non esiste una policy predefinita, assegnare una stringa genera TypeError.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML and className</title>
</head>
<body>
<script>
{
const card = document.createElement("div");
card.className = "card muted";
card.innerHTML = "<strong>Ready</strong>";
const original = card.firstElementChild;
card.className = "card active";
card.classList.add("highlight");
console.log(card.className);
console.log(card.firstElementChild === original);
card.innerHTML = "<strong>Ready</strong>";
console.log(card.firstElementChild === original);
console.log(card.innerHTML);
}
</script>
</body>
</html>Risultato
card active highlight true false <strong>Ready</strong>
Salva l’esempio completo come file HTML e aprilo nel browser, senza una CSP che imponga Trusted Types. Il risultato appare nella console del browser. L’elemento resta fuori dal documento. Cambiare le classi conserva il nodo figlio; assegnare HTML identico lo sostituisce.
Lezioni correlate
- JavaScript · Lezione 42 · Intermedio · Versione: 3