CKTIS / JavaScript
Element.innerHTML, tagName e namespaceURI
Lê e substitui a marcação de um elemento do DOM e distingue elementos pelo nome local e pelo espaço de nomes quando HTML e SVG coexistem na mesma árvore.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
element.innerHTML
element.innerHTML = markup
element.tagName
element.namespaceURIinnerHTML devolve o conteúdo atual do elemento como uma cadeia de caracteres serializada, sem as etiquetas do próprio elemento nem as raízes do Shadow DOM. Atribuir uma cadeia de caracteres ou um valor TrustedHTML faz com que um fragmento seja analisado no contexto do elemento e substitua os seus nós filhos, não o elemento em si. As referências aos nós antigos continuam a apontar para esses objetos, não para os novos nós. Num elemento HTML template, a leitura e a escrita operam sobre o seu content. Atribuir null equivale a atribuir uma cadeia vazia.
Um documento HTML usa o analisador de HTML, que pode recuperar de erros de marcação. Um documento XML, incluindo XHTML servido como XML, usa o analisador de XML. Um fragmento que não esteja bem formado lança uma DOMException com o nome SyntaxError.
tagName é o nome qualificado, só de leitura, que inclui o prefixo quando existe. As letras ASCII do nome são convertidas em maiúsculas apenas nos elementos do espaço de nomes HTML que pertencem a um documento HTML. namespaceURI também é só de leitura: devolve o URI do espaço de nomes definido na criação do elemento, ou null se não houver espaço de nomes. Mover o elemento ou alterar um atributo xmlns não altera esse valor. Numa árvore com vários espaços de nomes, compara namespaceURI e localName (o nome sem prefixo). Usa document.createElementNS() para escolher explicitamente o espaço de nomes na criação do elemento.
Não atribuas marcação não fiável a innerHTML: por predefinição, não remove conteúdo perigoso e pode permitir ataques XSS, por exemplo através de atributos de tratamento de eventos. Para texto simples, usa textContent. Se a CSP impuser Trusted Types, atribuir uma cadeia de caracteres normal sem uma política predefinida lança um TypeError. Um valor TrustedHTML só é tão seguro quanto a política que o produziu. Estas APIs pertencem à plataforma web, não ao ECMAScript 2024; não pressuponhas que existem em ambientes sem DOM.
Exemplos
<!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 o exemplo num ficheiro `.html` e abre-o diretamente num navegador. Consulta o resultado na consola das ferramentas de desenvolvimento. Ambos os elementos têm `a` como `localName`, mas os seus valores de `tagName` e `namespaceURI` são diferentes. O último `true` indica que o nó filho anterior já não tem nó pai.
Lições relacionadas
- JavaScript · Lição 16 · Avançado · Versão: 4