Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes