Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti