CKTIS / JavaScript
Element: výber potomkov, kontrola atribútov a meranie obdĺžnikov
Pomocou `querySelectorAll()` nájdeš vyhovujúcich potomkov, pomocou `hasAttribute()` overíš prítomnosť atribútu a pomocou `getClientRects()` zistíš geometriu rozloženia. Ani jeden z týchto výsledkov sám osebe nehovorí, či používateľ prvok vidí.
Verzia: Current web platform; runtime support varies
Syntax
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListTieto tri metódy rozhrania Element odpovedajú na rôzne otázky: čo vyhovuje v DOM, ktorý atribút je prítomný a aké obdĺžniky vzniknú pri rozložení stránky. Patria k webovej platforme, nie k ECMAScript 2024. Príklad vyžaduje prehliadač s DOM a mechanizmom na výpočet rozloženia.
element.querySelectorAll(selectors) prijíma reťazec so selektorom CSS alebo so zoznamom selektorov. Vracia statický NodeList vyhovujúcich potomkov v poradí dokumentu bez prvku, na ktorom metódu voláš. Ak nič nevyhovuje, zoznam je prázdny; neplatná syntax selektora vyvolá výnimku DOMException s názvom SyntaxError. Zmeny DOM nemenia, ktoré uzly sú v uloženom zozname, no jeho položky stále odkazujú na pôvodné uzly. Pri vyhodnocovaní selektora môžu zavážiť aj predkovia mimo prvku; :scope > .card vyberie len jeho priame deti s triedou .card. CSS.escape() použi na dynamický identifikátor, nie na celý selektor.
element.hasAttribute(name) zisťuje, či má prvok uvedený atribút: vráti true, aj keď je hodnota prázdna, a false, ak atribút chýba. Hodnotu nečíta a nekontroluje potomkov. Na prečítanie hodnoty použi getAttribute(name). Na kontrolu podľa priestoru názvov a lokálneho názvu bez predpony použi hasAttributeNS(namespace, localName).
element.getClientRects() neprijíma žiadne argumenty. Pri prvku HTML zvyčajne vracia kolekciu objektov DOMRect, po jednom pre každý fragment CSS boxu až po vonkajší okraj orámovania. Riadkový prvok rozdelený do viacerých riadkov môže mať viac obdĺžnikov. Súradnice sú v pixeloch CSS vzhľadom na zobrazovaciu oblasť a zohľadňujú posúvanie. Po zmene rozloženia meraj znova. Jeden ohraničujúci obdĺžnik získaš pomocou getBoundingClientRect().
display: none dá prázdnu kolekciu obdĺžnikov, ale prvok neodstráni z DOM ani nevylúči zhodu so selektorom. Neprázdna kolekcia nedokazuje viditeľnosť: prvok môže byť mimo zobrazovacej oblasti alebo mať visibility: hidden. hasAttribute("hidden") kontroluje len prítomnosť atribútu HTML, nie stav vykresľovania.
Prí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ýsledok
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup v konzole. Vyhovujú obe deti: prvé má prázdny atribút `data-flag` a jeden obdĺžnik, druhé atribút nemá a kvôli `display: none` nemá žiadny obdĺžnik. Po odstránení druhého dieťaťa má uložený zoznam stále dve položky, ale nový dotaz vráti jednu.
Súvisiace lekcie
- JavaScript · Lekcia 40 · Stredne pokročilá · Verzia: 3