CKTIS / JavaScript
Element: selecionar descendentes, verificar atributos e medir retângulos
Usa `querySelectorAll()` para encontrar os descendentes que correspondem ao seletor, `hasAttribute()` para verificar a presença de um atributo e `getClientRects()` para ler a geometria da disposição da página. Nenhum dos resultados, por si só, confirma que o elemento está visível.
Versão: Current web platform; runtime support varies
Sintaxe
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListEstes três métodos de Element respondem a perguntas distintas: o que corresponde no DOM, que atributo está presente e que retângulos resultam da disposição da página? São API da plataforma Web, não funcionalidades de ECMAScript 2024. O exemplo requer um navegador com DOM e motor de layout.
element.querySelectorAll(selectors) recebe uma cadeia de caracteres com um seletor CSS ou uma lista de seletores. Devolve uma NodeList estática com os descendentes que correspondem, pela ordem do documento, sem incluir o elemento onde o método é chamado. Se não houver correspondências, a lista fica vazia; uma sintaxe de seletor inválida lança uma DOMException com o nome SyntaxError. As alterações ao DOM não mudam os nós que constam da lista guardada, mas as entradas continuam a referir-se aos nós originais. Os antepassados fora do elemento podem contribuir para a correspondência; :scope > .card seleciona apenas os seus filhos diretos com a classe .card. Aplica CSS.escape() ao identificador dinâmico, não ao seletor inteiro.
element.hasAttribute(name) verifica se o elemento tem o atributo indicado: devolve true mesmo se o valor estiver vazio e false se o atributo não existir. Não lê o valor nem verifica os descendentes. Para ler o valor, usa getAttribute(name). Para verificar um atributo pelo espaço de nomes e pelo nome local sem prefixo, usa hasAttributeNS(namespace, localName).
element.getClientRects() não recebe argumentos. Para um elemento HTML, devolve geralmente uma coleção de objetos DOMRect, um por fragmento da caixa CSS até à extremidade exterior do contorno. Um elemento em linha que ocupe várias linhas pode ter vários retângulos. As coordenadas são dadas em píxeis CSS relativamente à área de visualização e têm em conta o deslocamento da página. Volta a medir se a disposição mudar. Para obter um único retângulo envolvente, usa getBoundingClientRect().
display: none dá uma coleção vazia de retângulos, mas não retira o elemento do DOM nem o impede de corresponder a um seletor. Uma coleção não vazia não prova que o elemento esteja visível: pode estar fora da área de visualização ou ter visibility: hidden. hasAttribute("hidden") só verifica a presença do atributo HTML, não o estado de renderização.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element layout example</title>
</head>
<body>
<script>
(() => {
const root = document.createElement("section");
const shown = document.createElement("div");
const hidden = document.createElement("div");
shown.className = hidden.className = "card";
shown.setAttribute("data-flag", "");
shown.style.cssText = "display: block; width: 10px; height: 10px";
hidden.style.display = "none";
root.append(shown, hidden);
document.body.append(root);
try {
const selector = ":scope > .card";
const cards = root.querySelectorAll(selector);
for (const card of cards) {
console.log(`flag=${card.hasAttribute("data-flag")} boxes=${card.getClientRects().length}`);
}
hidden.remove();
console.log(`saved=${cards.length} fresh=${root.querySelectorAll(selector).length}`);
} finally {
root.remove();
}
})();
</script>
</body>
</html>Resultado
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Guarda o exemplo como ficheiro HTML, abre-o num navegador e verifica o resultado na consola. Ambos os filhos correspondem: o primeiro tem um atributo `data-flag` vazio e um retângulo; o segundo não tem o atributo nem retângulos devido a `display: none`. Depois de remover o segundo, a lista guardada continua com duas entradas, mas uma nova consulta devolve apenas uma.
Lições relacionadas
- JavaScript · Lição 40 · Intermédio · Versão: 3