Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.replaceChildren() e Element.className

Sostituisci o rimuovi tutti i nodi figli di un elemento e leggi o imposta l’intero valore del suo attributo `class` senza modificare quei nodi.

Versione: Current web platform; runtime support varies

Sintassi

element.replaceChildren();
element.replaceChildren(node, "text");
element.replaceChildren(...items); // Spread an iterable of nodes and/or strings.
const classes = element.className; // Read the class attribute of an HTML element.
element.className = "panel ready"; // Replace the entire class attribute value.

element.replaceChildren(...items) sostituisce tutti i nodi figli diretti, inclusi quelli di testo, e restituisce undefined. Una stessa chiamata accetta un numero qualsiasi di oggetti Node e stringhe. Le stringhe diventano nodi di testo e non vengono interpretate come HTML. Senza argomenti, la chiamata svuota l’elemento senza rimuoverlo né modificarne gli attributi.

I nodi esistenti vengono spostati, non clonati. Un nodo staccato dall’albero può essere riutilizzato se ne conservi un riferimento. Violare una regola dell’albero DOM, per esempio tentando di inserire un antenato come figlio dell’elemento, genera una DOMException chiamata HierarchyRequestError.

In un elemento HTML, la proprietà element.className riflette l’attributo class come stringa di nomi di classe separati da spazi bianchi. Un’assegnazione sostituisce l’intero valore senza modificare i nodi figli. Per modificare singole classi senza sostituire le altre, usa classList.add(), classList.remove() o classList.toggle(). Negli elementi SVG, className può essere un oggetto SVGAnimatedString; usa getAttribute('class') o setAttribute('class', value) per leggere o scrivere l’attributo stesso.

Nell’indicazione della versione, ECMAScript 2024 indica soltanto la versione di riferimento del linguaggio JavaScript. Queste API del DOM appartengono alla piattaforma web, non a ECMAScript 2024. La loro disponibilità dipende dall’ambiente di esecuzione; un ambiente privo di DOM non le fornisce da solo.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element.replaceChildren() and Element.className</title>
</head>
<body>
<script>
{
  const panel = document.createElement("div");
  panel.className = "panel loading";
  panel.textContent = "Loading…";

  const label = document.createElement("span");
  label.textContent = "Ready";
  panel.replaceChildren(label, " <pending>");
  panel.className = "panel ready";
  console.log(`${panel.childNodes.length} | ${panel.textContent} | ${panel.className}`);

  panel.replaceChildren();
  console.log(`${panel.childNodes.length} | ${panel.className}`);
}
</script>
</body>
</html>

Risultato

2 | Ready <pending> | panel ready
0 | panel ready

Salva l’esempio come file HTML, aprilo in un browser e controlla la console del browser. La prima riga mostra due nodi figli: l’elemento `span` e il testo letterale ` <pending>`. La seconda mostra che, dopo la rimozione dei figli, l’attributo `class` mantiene il valore `panel ready`.

Lezioni correlate

  • JavaScript · Lezione 43 · Intermedio · Versione: 3

Fonti