CKTIS / JavaScript
Element: izbiranje potomcev, preverjanje atributov in merjenje pravokotnikov
Z `querySelectorAll()` poiščeš ustrezne potomce, z `hasAttribute()` preveriš prisotnost atributa, z `getClientRects()` pa prebereš geometrijo postavitve. Noben od teh rezultatov sam po sebi ne pove, ali uporabnik element vidi.
Različica: Current web platform; runtime support varies
Sintaksa
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListTe tri metode vmesnika Element odgovarjajo na različna vprašanja: kaj se ujema v DOM-u, kateri atribut je prisoten in kakšni pravokotniki nastanejo pri postavitvi strani. So del spletne platforme, ne ECMAScript 2024. Primer potrebuje brskalnik z DOM-om in mehanizmom za izračun postavitve.
element.querySelectorAll(selectors) sprejme niz s selektorjem CSS ali seznamom selektorjev. Vrne statični NodeList ujemajočih se potomcev v vrstnem redu dokumenta, brez elementa, na katerem kličeš metodo. Če ni zadetkov, je seznam prazen; neveljavna skladnja selektorja sproži izjemo DOMException z imenom SyntaxError. Spremembe DOM-a ne spremenijo tega, katera vozlišča so na shranjenem seznamu, toda postavke še vedno kažejo na izvorna vozlišča. Pri ujemanju lahko sodelujejo tudi predniki zunaj elementa; :scope > .card izbere samo njegove neposredne otroke z razredom .card. CSS.escape() uporabi za dinamični identifikator, ne za celoten selektor.
element.hasAttribute(name) preveri, ali je navedeni atribut na elementu: vrne true, tudi če je vrednost prazna, in false, če atributa ni. Ne prebere vrednosti in ne preverja potomcev. Za branje vrednosti uporabi getAttribute(name). Za preverjanje po imenskem prostoru in lokalnem imenu brez predpone uporabi hasAttributeNS(namespace, localName).
element.getClientRects() ne sprejme argumentov. Za element HTML običajno vrne zbirko predmetov DOMRect, po enega za vsak fragment okvirja CSS do zunanjega roba obrobe. Vrstični element, razdeljen med več vrstic, ima lahko več pravokotnikov. Koordinate so podane v slikovnih pikah CSS glede na vidno polje in upoštevajo drsenje. Po spremembi postavitve izmeri znova. Za en sam obdajajoči pravokotnik uporabi getBoundingClientRect().
display: none da prazno zbirko pravokotnikov, vendar elementa ne odstrani iz DOM-a in ne prepreči ujemanja s selektorjem. Neprazna zbirka ne dokazuje vidnosti: element je lahko zunaj vidnega polja ali ima visibility: hidden. hasAttribute("hidden") preveri samo prisotnost atributa HTML, ne stanja izrisovanja.
Primeri
<!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>Rezultat
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli. Ujemata se oba otroka: prvi ima prazen atribut `data-flag` in en pravokotnik, drugi pa nima atributa in zaradi `display: none` nima pravokotnikov. Ko odstraniš drugega otroka, ima shranjeni seznam še vedno dve postavki, nova poizvedba pa vrne eno.
Povezane lekcije
- JavaScript · Lekcija 40 · Srednja · Različica: 3