CKTIS / JavaScript
Element: afstammelingen selecteren, attributen controleren en rechthoeken meten
Gebruik `querySelectorAll()` om passende afstammelingen te vinden, `hasAttribute()` om te controleren of een attribuut aanwezig is en `getClientRects()` om de lay-outgeometrie op te vragen. Geen van deze resultaten bewijst op zichzelf dat het element zichtbaar is.
Versie: Current web platform; runtime support varies
Syntax
element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectListDeze drie methoden van Element beantwoorden verschillende vragen: wat komt overeen in de DOM, welk attribuut is aanwezig en welke rechthoeken levert de lay-out op? Het zijn API’s van het webplatform, geen onderdelen van ECMAScript 2024. Het voorbeeld vereist een browser met een DOM en een lay-outengine.
element.querySelectorAll(selectors) verwacht een tekenreeks met een CSS-selector of een lijst met selectors. De methode retourneert een statische NodeList met passende afstammelingen in documentvolgorde, zonder het element zelf. Zonder treffers is de lijst leeg; ongeldige selectorsyntaxis veroorzaakt een DOMException met de naam SyntaxError. Wijzigingen in de DOM veranderen niet welke knooppunten in de opgeslagen lijst staan, maar de vermeldingen verwijzen nog steeds naar de oorspronkelijke knooppunten. Bovenliggende elementen buiten het element kunnen meespelen bij het matchen; :scope > .card selecteert alleen de directe kinderen ervan met de klasse .card. Gebruik CSS.escape() op een dynamische identifier, niet op de volledige selector.
element.hasAttribute(name) controleert of het genoemde attribuut op dat element aanwezig is: de methode retourneert true bij een lege waarde en false als het attribuut ontbreekt. Ze leest de waarde niet en controleert geen afstammelingen. Gebruik getAttribute(name) om de waarde te lezen. Gebruik hasAttributeNS(namespace, localName) om te controleren op naamruimte en lokale naam zonder voorvoegsel.
element.getClientRects() neemt geen argumenten. Voor een HTML-element retourneert de methode doorgaans een verzameling DOMRect-objecten, één per fragment van de CSS-box tot aan de buitenrand van de omlijning. Een inline-element dat over meerdere regels loopt, kan meerdere rechthoeken hebben. De coördinaten zijn in CSS-pixels ten opzichte van de viewport en houden rekening met scrollen. Meet opnieuw na wijzigingen in de lay-out. Gebruik getBoundingClientRect() als je één omsluitende rechthoek wilt.
display: none levert een lege verzameling rechthoeken op, maar verwijdert het element niet uit de DOM en sluit een selectormatch niet uit. Een niet-lege verzameling bewijst geen zichtbaarheid: het element kan buiten het zichtbare gebied staan of visibility: hidden hebben. hasAttribute("hidden") controleert alleen de aanwezigheid van het HTML-attribuut, niet de weergavestatus.
Voorbeelden
<!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>Resultaat
flag=true boxes=1 flag=false boxes=0 saved=2 fresh=1
Sla het voorbeeld op als HTML-bestand, open het in een browser en controleer de uitvoer in de browserconsole. Beide kinderen voldoen aan de selector: het eerste heeft een leeg `data-flag`-attribuut en één rechthoek; het tweede heeft het attribuut niet en heeft door `display: none` geen rechthoeken. Na verwijdering van het tweede kind bevat de opgeslagen lijst nog twee vermeldingen, terwijl een nieuwe zoekopdracht er één oplevert.
Gerelateerde lessen
- JavaScript · Les 40 · Gemiddeld · Versie: 3