CKTIS / JavaScript
Element: odabir potomaka, provjera atributa i mjerenje pravokutnika
Metodom `querySelectorAll()` pronađi potomke koji odgovaraju selektoru, metodom `hasAttribute()` provjeri prisutnost atributa, a metodom `getClientRects()` očitaj geometriju rasporeda. Nijedan rezultat sam po sebi ne govori vidi li korisnik element.
Verzija: Current web platform; runtime support varies
Sintaksa
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListOve tri metode sučelja Element odgovaraju na različita pitanja: što se podudara u DOM-u, koji je atribut prisutan i koje pravokutnike daje raspored stranice? Dio su web-platforme, a ne ECMAScripta 2024. Za primjer je potreban preglednik s DOM-om i mehanizmom za izračun rasporeda.
element.querySelectorAll(selectors) prima znakovni niz sa selektorom CSS-a ili popisom selektora. Vraća statičan NodeList potomaka koji se podudaraju, redoslijedom kojim se pojavljuju u dokumentu, bez elementa na kojem je metoda pozvana. Ako nema podudaranja, popis je prazan; nevaljana sintaksa selektora izaziva iznimku DOMException naziva SyntaxError. Promjene DOM-a ne mijenjaju koji su čvorovi na spremljenom popisu, ali stavke i dalje upućuju na izvorne čvorove. U podudaranju selektora mogu sudjelovati i preci izvan elementa; :scope > .card odabire samo njegovu izravnu djecu s klasom .card. Primijeni CSS.escape() na dinamički identifikator, ne na cijeli selektor.
element.hasAttribute(name) provjerava ima li element navedeni atribut: vraća true i ako je vrijednost prazna, a false ako atribut nedostaje. Ne čita vrijednost niti provjerava potomke. Za čitanje vrijednosti koristi getAttribute(name). Za provjeru prema imenskom prostoru i lokalnom nazivu bez prefiksa koristi hasAttributeNS(namespace, localName).
element.getClientRects() ne prima argumente. Za element HTML-a obično vraća zbirku objekata DOMRect, po jedan za svaki fragment CSS okvira do vanjskog ruba obruba. Element unutar retka koji se proteže kroz više redaka može imati više pravokutnika. Koordinate su izražene u CSS pikselima u odnosu na područje prikaza i uzimaju u obzir pomicanje sadržaja. Nakon promjene rasporeda ponovi mjerenje. Za jedan obuhvatni pravokutnik koristi getBoundingClientRect().
display: none daje praznu zbirku pravokutnika, ali ne uklanja element iz DOM-a niti sprječava podudaranje sa selektorom. Zbirka koja nije prazna ne dokazuje vidljivost: element može biti izvan područja prikaza ili imati visibility: hidden. hasAttribute("hidden") provjerava samo prisutnost HTML atributa, a ne stanje iscrtavanja.
Primjeri
<!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
Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli. Oba elementa djeteta odgovaraju selektoru: prvi ima prazan atribut `data-flag` i jedan pravokutnik, a drugi nema atribut ni pravokutnike zbog `display: none`. Nakon uklanjanja drugog elementa spremljeni popis još ima dvije stavke, ali novi upit vraća jednu.
Povezane lekcije
- JavaScript · Lekcija 40 · Srednje · Verzija: 3