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

CKTIS / JavaScript

Element.innerHTML y Element.className

Usa `innerHTML` para leer o sustituir el contenido de un elemento y `className` para leer o definir sus clases CSS.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;

innerHTML y className son dos propiedades de instancia del DOM, no métodos. Pertenecen a la plataforma web, no a ECMAScript 2024: un entorno de JavaScript sin DOM no las proporciona.

Al leer element.innerHTML, se serializa el contenido actual en una cadena, sin incluir las etiquetas del propio elemento ni las raíces del DOM en la sombra. Al asignarle un valor, se analiza un fragmento como HTML o XML según el documento y se sustituyen los nodos hijos, no el elemento en sí. Incluso un marcado idéntico crea nodos nuevos: las referencias antiguas siguen apuntando a los nodos retirados y sus escuchadores de eventos no se transfieren. En un template, la asignación sustituye los nodos hijos del DocumentFragment al que apunta content, no el fragmento en sí. Asignar null equivale a asignar "". En un documento XML, un fragmento mal formado provoca SyntaxError, y un error de serialización puede provocar InvalidStateError; ambos son nombres de DOMException.

En elementos HTML, element.className refleja el atributo class como una cadena de nombres separados por espacios en blanco. Asignarle un valor sustituye todo el valor del atributo sin cambiar los nodos hijos. Para modificar una clase sin perder las demás, usa classList.add(), classList.remove() o classList.toggle(). En SVG, className puede ser un SVGAnimatedString; para leer o escribir el atributo entero, usa getAttribute("class") o setAttribute("class", value). getAttribute() devuelve null si el atributo no existe y "" si existe pero está vacío.

innerHTML no sanea la entrada de forma predeterminada: no le asignes directamente datos no confiables, ya que pueden dar lugar a ataques de scripts entre sitios (XSS). Para colocar texto plano en un elemento común, usa textContent y así no se analizará como HTML. Si necesitas marcado de una fuente no confiable, sanéalo primero. Cuando se admite Trusted Types, una política puede devolver contenido saneado como TrustedHTML; el tipo por sí solo no sanea. Si la CSP exige Trusted Types y no hay una política predeterminada, asignar una cadena provoca TypeError.

Ejemplos

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

Resultado

card active highlight
true
false
<strong>Ready</strong>

Guarda el ejemplo completo como archivo HTML y ábrelo en un navegador sin que la CSP exija Trusted Types. El resultado aparece en la consola del navegador. El elemento permanece fuera del documento. Cambiar sus clases conserva el nodo hijo; asignar HTML idéntico lo sustituye.

Lecciones relacionadas

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

Fuentes