Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Element.replaceChildren() y Element.className

Reemplaza o elimina todos los nodos hijos de un elemento y lee o establece el valor completo de su atributo `class` sin modificar esos nodos.

Versión: Current web platform; runtime support varies

Sintaxis

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) reemplaza todos los nodos hijos directos, incluidos los de texto, y devuelve undefined. Una misma llamada admite cualquier cantidad de objetos Node y cadenas. Las cadenas se convierten en nodos de texto y no se interpretan como HTML. Sin argumentos, la llamada vacía el elemento sin eliminarlo ni modificar sus atributos.

Los nodos existentes se mueven, no se clonan. Un nodo separado del árbol se puede reutilizar si conservas una referencia a él. Incumplir una regla del árbol DOM, por ejemplo al intentar insertar un ancestro como hijo del elemento, lanza una DOMException llamada HierarchyRequestError.

En un elemento HTML, la propiedad element.className refleja el atributo class como una cadena de nombres de clase separados por caracteres de espacio en blanco. Asignarle un valor sustituye el valor completo sin cambiar los nodos hijos. Para modificar clases individuales sin sustituir las demás, usa classList.add(), classList.remove() o classList.toggle(). En elementos SVG, className puede ser un objeto SVGAnimatedString; usa getAttribute('class') o setAttribute('class', value) para leer o escribir el propio atributo.

En la indicación de versión, ECMAScript 2024 solo señala la versión de referencia del lenguaje JavaScript. Estas API del DOM pertenecen a la plataforma web, no a ECMAScript 2024. Su disponibilidad depende del entorno de ejecución; un entorno sin DOM no las proporciona por sí solo.

Ejemplos

<!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>

Resultado

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

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta su consola. La primera línea muestra dos nodos hijos: el elemento `span` y el texto literal ` <pending>`. La segunda muestra que, al eliminar los hijos, el atributo `class` conserva el valor `panel ready`.

Lecciones relacionadas

  • JavaScript · Lección 43 · Intermedio · Versión: 3

Fuentes