CKTIS / JavaScript
`className` e `innerHTML`: clases y contenido de un elemento
`className` refleja el atributo `class`. `innerHTML` devuelve el marcado serializado del contenido o interpreta un fragmento para sustituirlo.
Versión: Current web platform; runtime support varies
Sintaxis
element.className;
htmlElement.className = classString;
element.innerHTML;
element.innerHTML = markup;className e innerHTML son dos propiedades de instancia del DOM, no métodos ni características del lenguaje ECMAScript. Las proporciona un entorno con DOM, no el motor de JavaScript por sí solo.
En un elemento HTML, className lee el atributo class como una cadena (vacía si falta el atributo), y una asignación sustituye todo el valor del atributo. Para añadir, quitar o alternar una clase sin perder las demás, usa classList.add(), remove() o toggle(). En un elemento SVG, className puede ser un objeto SVGAnimatedString en lugar de una cadena. Si tu código trabaja con ambos tipos de elementos, usa getAttribute("class") y setAttribute("class", value) para leer y escribir el texto del atributo. Si el atributo no existe, getAttribute() devuelve null.
Al leer innerHTML, se serializa el contenido como HTML o XML, sin incluir las etiquetas del propio elemento ni las raíces del Shadow DOM. El resultado no tiene por qué reproducir el texto fuente original. Al asignar un valor, se analiza un fragmento en el contexto del elemento y se sustituyen sus nodos hijos sin sustituir el propio elemento. En un template, se sustituye el contenido de la plantilla. Los nodos anteriores se desconectan; las referencias siguen apuntando a ellos y sus escuchadores de eventos no se transfieren a los nodos nuevos. En un documento XML, un fragmento mal formado provoca una DOMException llamada SyntaxError.
innerHTML no sanea el marcado. Los elementos script insertados no se ejecutan, pero los atributos de gestión de eventos aún pueden dar lugar a XSS. Para insertar texto plano en un elemento normal, usa textContent. Si necesitas marcado que no sea de confianza, sanéalo primero. Cuando una CSP compatible exige Trusted Types, asignar una cadena sin una política predeterminada provoca un TypeError. En su lugar, puedes pasar TrustedHTML generado por una política que sanee la entrada.
Ejemplos
<!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>Resultado
card ready true <strong>Ready</strong> true
Guarda el ejemplo en un archivo `.html`, ábrelo en un navegador y consulta la consola. El primer `true` demuestra que cambiar las clases conserva el nodo hijo anterior; el segundo, que asignar `innerHTML` lo desconecta.
Lecciones relacionadas
- JavaScript · Lección 11 · Avanzado · Versión: 4