CKTIS / JavaScript
Element : sélectionner des descendants, vérifier les attributs et mesurer les rectangles
Utilisez `querySelectorAll()` pour trouver les descendants correspondants, `hasAttribute()` pour vérifier la présence d’un attribut et `getClientRects()` pour lire la géométrie de mise en page. Aucun de ces résultats ne suffit à établir que l’élément est visible.
Version : Current web platform; runtime support varies
Syntaxe
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListCes trois méthodes d’Element répondent à des questions distinctes : quels éléments correspondent dans le DOM, quel attribut est présent et quels rectangles résultent de la mise en page ? Elles font partie de la plateforme web, pas d’ECMAScript 2024. L’exemple nécessite un navigateur doté d’un DOM et d’un moteur de mise en page.
element.querySelectorAll(selectors) prend une chaîne contenant un sélecteur CSS ou une liste de sélecteurs. La méthode renvoie une NodeList statique des descendants correspondants, dans l’ordre du document, sans inclure l’élément sur lequel elle est appelée. Sans correspondance, la liste est vide ; une syntaxe de sélecteur invalide déclenche une DOMException nommée SyntaxError. Les modifications du DOM ne changent pas la composition de la liste enregistrée, dont les entrées désignent toujours les nœuds d’origine. Des ancêtres extérieurs à l’élément peuvent intervenir dans la correspondance ; :scope > .card ne sélectionne que ses enfants directs de classe .card. Appliquez CSS.escape() à un identifiant dynamique, pas au sélecteur entier.
element.hasAttribute(name) vérifie la présence de l’attribut nommé sur cet élément : la méthode renvoie true même si la valeur est vide, et false si l’attribut est absent. Elle ne lit pas la valeur et ne teste pas les descendants. Pour lire la valeur, utilisez getAttribute(name). Pour vérifier un attribut par espace de noms et nom local sans préfixe, utilisez hasAttributeNS(namespace, localName).
element.getClientRects() ne prend aucun argument. Pour un élément HTML, la méthode renvoie généralement une collection d’objets DOMRect, un par fragment de boîte CSS jusqu’au bord extérieur de la bordure. Un élément en ligne réparti sur plusieurs lignes peut avoir plusieurs rectangles. Les coordonnées sont exprimées en pixels CSS relativement à la zone d’affichage et tiennent compte du défilement. Mesurez de nouveau après un changement de mise en page. Pour obtenir un seul rectangle englobant, utilisez getBoundingClientRect().
Avec display: none, la collection de rectangles est vide, mais l’élément reste dans le DOM et peut correspondre à un sélecteur. Une collection non vide ne prouve pas que l’élément est visible : il peut être hors de la zone d’affichage ou avoir visibility: hidden. hasAttribute("hidden") ne vérifie que la présence de l’attribut HTML, pas l’état du rendu.
Exemples
<!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>Résultat
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et vérifiez le résultat dans la console. Les deux enfants correspondent : le premier a un attribut `data-flag` vide et un rectangle ; le second n’a pas cet attribut et n’a aucun rectangle à cause de `display: none`. Après sa suppression, la liste enregistrée conserve deux entrées, mais une nouvelle requête n’en renvoie qu’une.
Leçons associées
- JavaScript · Leçon 40 · Intermédiaire · Version : 3