CKTIS / JavaScript
Element: substituir nós filhos e verificar a presença de um atributo
Usa `replaceChildren()` para substituir ou remover os nós filhos de um elemento e `hasAttribute()` para verificar se o próprio elemento tem um atributo, seja qual for o seu valor.
Versão: Current web platform; runtime support varies
Sintaxe
element.replaceChildren();
element.replaceChildren(firstNodeOrString, secondNodeOrString, ...moreNodesOrStrings);
element.hasAttribute(qualifiedName);replaceChildren() e hasAttribute() são métodos de instância de Element no DOM. O primeiro altera os nós diretamente abaixo de um elemento; o segundo verifica um atributo do próprio elemento sem alterar o DOM. São APIs da plataforma Web, não funcionalidades do ECMAScript 2024. Confirma que o ambiente de execução de destino disponibiliza um DOM e suporta ambos os métodos.
element.replaceChildren(...) substitui todos os nós filhos diretos, incluindo os de texto e de comentário. Aceita qualquer número de nós e cadeias de caracteres. Sem argumentos, esvazia o elemento sem o remover nem alterar os seus atributos. As cadeias tornam-se nós de texto, pelo que, ao contrário de uma atribuição a innerHTML, não são interpretadas como HTML. O método devolve undefined.
Os nós existentes são movidos, não clonados. Um nó removido fica desligado do nó pai, mas podes continuar a usá-lo se guardares uma referência. Uma inserção que criaria um ciclo, como tornar um elemento filho de si próprio, lança uma DOMException com o nome HierarchyRequestError.
element.hasAttribute(name) procura um atributo pelo nome qualificado e devolve true mesmo quando o valor é vazio ou é a cadeia "false". Um resultado false indica que o atributo está ausente, não que o seu valor seja falso. Para ler o valor, usa getAttribute(name), que devolve null se o atributo não existir. Para procurar pelo espaço de nomes e pelo nome local, usa hasAttributeNS(namespace, localName). Num atributo booleano HTML como disabled, o que conta é a presença: definir o valor como "false" não o desativa.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Replacing child nodes and checking attribute presence</title>
</head>
<body>
<script>
(() => {
const panel = document.createElement("div");
const label = document.createElement("strong");
label.textContent = "Updated";
panel.append("Old: ", label);
console.log(`before: ${panel.hasAttribute("data-ready")}`);
panel.setAttribute("data-ready", "");
panel.replaceChildren("<b>literal</b> ", label);
console.log(`text: ${panel.textContent}`);
console.log(`same node: ${panel.lastChild === label}`);
panel.replaceChildren();
console.log(`child nodes: ${panel.childNodes.length}`);
console.log(`after: ${panel.hasAttribute("data-ready")}`);
console.log(`value: ${JSON.stringify(panel.getAttribute("data-ready"))}`);
})();
</script>
</body>
</html>Resultado
before: false text: <b>literal</b> Updated same node: true child nodes: 0 after: true value: ""
Guarda o exemplo num ficheiro `.html`, abre-o num navegador e verifica o resultado na consola. A cadeia que se parece com HTML continua a ser texto e `same node: true` confirma que `label` continua a ser o mesmo nó. Depois de esvaziado, o elemento mantém `data-ready` com um valor vazio.
Lições relacionadas
- JavaScript · Lição 38 · Avançado · Versão: 4