CKTIS / JavaScript
`className` e `innerHTML`: classi e contenuto di un elemento
`className` riflette l’attributo `class`. `innerHTML` legge il markup serializzato del contenuto o analizza un frammento per sostituirlo.
Versione: Current web platform; runtime support varies
Sintassi
element.className;
htmlElement.className = classString;
element.innerHTML;
element.innerHTML = markup;className e innerHTML sono due proprietà di istanza del DOM, non metodi né funzionalità del linguaggio ECMAScript. Le fornisce un ambiente con un DOM, non il solo motore JavaScript.
In un elemento HTML, className legge l’attributo class come stringa (vuota se l’attributo è assente), mentre un’assegnazione ne sostituisce l’intero valore. Per aggiungere, rimuovere o attivare e disattivare una classe senza perdere le altre, usa classList.add(), remove() o toggle(). Negli elementi SVG, className può essere un oggetto SVGAnimatedString anziché una stringa. Per gestire entrambi i tipi di elemento, usa getAttribute("class") e setAttribute("class", value) per leggere e scrivere il testo dell’attributo. Se l’attributo è assente, getAttribute() restituisce null.
La lettura di innerHTML serializza il contenuto come HTML o XML, senza includere i tag dell’elemento stesso né le radici dello Shadow DOM. Il risultato non riproduce necessariamente il testo sorgente originale. L’assegnazione analizza un frammento nel contesto dell’elemento e ne sostituisce i nodi figli, senza sostituire l’elemento stesso. In un template viene sostituito invece il contenuto del modello. I vecchi nodi vengono scollegati; i riferimenti continuano a puntare a essi e i loro listener di eventi non vengono trasferiti ai nuovi nodi. In un documento XML, un frammento non ben formato genera una DOMException chiamata SyntaxError.
innerHTML non sanifica il markup. Gli elementi script inseriti non vengono eseguiti, ma gli attributi dei gestori di eventi possono comunque consentire un attacco XSS. Per inserire testo semplice in un elemento ordinario, usa textContent. Se ti serve markup non attendibile, sanificalo prima. Quando una CSP supportata impone Trusted Types, assegnare una stringa senza una policy predefinita genera un TypeError. Puoi invece passare TrustedHTML prodotto da una policy che sanifica l’input.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>className and innerHTML</title>
<script>
const card = document.createElement("div");
const oldChild = document.createElement("span");
card.append(oldChild);
card.className = "card draft";
card.className = "card ready";
console.log(card.className);
console.log(oldChild.parentNode === card);
card.innerHTML = "<strong>Ready</strong>";
console.log(card.innerHTML);
console.log(oldChild.parentNode === null);
</script>Risultato
card ready true <strong>Ready</strong> true
Salva l’esempio in un file `.html`, aprilo in un browser e controlla la console. Il primo `true` mostra che la modifica delle classi conserva il vecchio nodo figlio; il secondo mostra che l’assegnazione a `innerHTML` lo scollega.
Lezioni correlate
- JavaScript · Lezione 11 · Avanzato · Versione: 4