CKTIS / JavaScript
Element: výběr potomků, kontrola atributů a měření obdélníků
Pomocí `querySelectorAll()` najdeš odpovídající potomky, pomocí `hasAttribute()` ověříš přítomnost atributu a pomocí `getClientRects()` zjistíš geometrii rozložení. Žádný z těchto výsledků sám o sobě neříká, zda uživatel prvek vidí.
Verze: Current web platform; runtime support varies
Syntaxe
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListTyto tři metody rozhraní Element odpovídají na různé otázky: co vyhovuje v DOM, který atribut je přítomen a jaké obdélníky vzniknou při rozložení stránky. Patří k webové platformě, nikoli k ECMAScript 2024. Příklad vyžaduje prohlížeč s DOM a mechanismem pro výpočet rozložení.
element.querySelectorAll(selectors) přijímá řetězec s CSS selektorem nebo seznamem selektorů. Vrací statický NodeList odpovídajících potomků v pořadí dokumentu, bez samotného prvku, na němž metodu voláš. Bez shody dostaneš prázdný seznam; neplatná syntaxe selektoru vyvolá výjimku DOMException s názvem SyntaxError. Změny DOM nemění, které uzly jsou v uloženém seznamu, ale položky stále odkazují na původní uzly. Při vyhodnocování selektoru mohou hrát roli i předci vně prvku; :scope > .card vybere pouze jeho přímé potomky s třídou .card. CSS.escape() použij na dynamický identifikátor, nikoli na celý selektor.
element.hasAttribute(name) kontroluje, zda má daný prvek uvedený atribut: i pro prázdnou hodnotu vrátí true, při absenci atributu vrátí false. Hodnotu nečte a potomky nekontroluje. Hodnotu přečteš pomocí getAttribute(name). Pro hledání podle jmenného prostoru a místního názvu bez předpony použij hasAttributeNS(namespace, localName).
element.getClientRects() nepřijímá žádné argumenty. U prvku HTML obvykle vrací kolekci objektů DOMRect, jeden pro každý fragment CSS boxu až po vnější hranu rámečku. Řádkový prvek rozdělený do více řádků může mít více obdélníků. Souřadnice jsou v pixelech CSS vzhledem k zobrazovací oblasti a zohledňují posun při rolování. Po změně rozložení měř znovu. Jeden obalový obdélník získáš pomocí getBoundingClientRect().
display: none vede k prázdné kolekci obdélníků, prvek ale z DOM neodstraní a nevyloučí shodu se selektorem. Neprázdná kolekce nedokazuje viditelnost: prvek může být mimo zobrazovací oblast nebo mít visibility: hidden. hasAttribute("hidden") ověřuje jen přítomnost atributu HTML, nikoli stav vykreslení.
Příklady
<!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>Výsledek
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup v konzoli. Vyhovují oba potomci: první má prázdný atribut `data-flag` a jeden obdélník, druhý atribut nemá a kvůli `display: none` nemá žádný obdélník. Po odebrání druhého potomka má uložený seznam stále dvě položky, ale nový dotaz vrátí jednu.
Související lekce
- JavaScript · Lekce 40 · Středně pokročilá · Verze: 3