CKTIS / JavaScript
Element.innerHTML, tagName y namespaceURI
Lee y sustituye el marcado de un elemento del DOM y distingue los elementos por su nombre local y espacio de nombres cuando HTML y SVG comparten el mismo árbol.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
element.innerHTML
element.innerHTML = markup
element.tagName
element.namespaceURIinnerHTML devuelve, como cadena serializada, el contenido actual del elemento, sin las etiquetas del propio elemento ni las raíces del Shadow DOM. Al asignar una cadena o un valor TrustedHTML, se analiza un fragmento en el contexto del elemento y se sustituyen sus nodos hijos, no el elemento en sí. Las referencias a los nodos anteriores siguen apuntando a esos objetos, no a los nuevos. En un elemento HTML template, la lectura y la escritura operan sobre su content. Asignar null equivale a asignar una cadena vacía.
Un documento HTML usa el analizador de HTML, que puede recuperarse de errores de marcado. Un documento XML, incluido XHTML servido como XML, usa el analizador de XML. Un fragmento que no esté bien formado provoca una DOMException llamada SyntaxError.
tagName es el nombre cualificado de solo lectura e incluye el prefijo si lo hay. Solo se convierten a mayúsculas las letras ASCII del nombre cuando el elemento pertenece al espacio de nombres HTML y su documento es HTML. namespaceURI también es de solo lectura: devuelve el URI del espacio de nombres fijado al crear el elemento, o null si no tiene espacio de nombres. Mover el elemento o modificar un atributo xmlns no cambia ese valor. En un árbol con varios espacios de nombres, compara namespaceURI y localName (el nombre sin prefijo). Usa document.createElementNS() para elegir el espacio de nombres al crear el elemento.
No asignes marcado no fiable a innerHTML: no lo depura por defecto y puede permitir ataques XSS, por ejemplo mediante atributos de gestión de eventos. Para texto sin formato, usa textContent. Si la CSP exige Trusted Types, asignar una cadena normal sin una política predeterminada provoca un TypeError. Un valor TrustedHTML es tan seguro como la política que lo produjo. Estas API pertenecen a la plataforma web, no a ECMAScript 2024; no des por hecho que existan en entornos sin DOM.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML and SVG element names</title>
</head>
<body>
<script>
const container = document.createElement('div');
const previous = document.createElement('span');
container.appendChild(previous);
container.innerHTML = '<a>HTML</a><svg><a>SVG</a></svg>';
const htmlLink = container.firstElementChild;
const svgLink = container.lastElementChild.firstElementChild;
console.log(container.innerHTML);
for (const link of [htmlLink, svgLink]) {
console.log(`${link.tagName} | ${link.localName} | ${link.namespaceURI}`);
}
console.log(previous.parentNode === null);
</script>
</body>
</html>Resultado
<a>HTML</a><svg><a>SVG</a></svg> A | a | http://www.w3.org/1999/xhtml a | a | http://www.w3.org/2000/svg true
Guarda el ejemplo como archivo `.html` y ábrelo directamente en un navegador. Consulta la salida en la consola de desarrollo. Ambos elementos tienen `a` como `localName`, pero sus valores de `tagName` y `namespaceURI` son distintos. El último `true` indica que el antiguo nodo hijo ya no tiene padre.
Lecciones relacionadas
- JavaScript · Lección 16 · Avanzado · Versión: 4