CKTIS / JavaScript
Element.querySelector() en Element.querySelectorAll()
Zoek met CSS-selectors naar afstammelingen van een element. Kies de eerste overeenkomst of een statische lijst met alle overeenkomsten.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.querySelector(selectors) // Element | null
element.querySelectorAll(selectors) // static NodeList of Element objectsquerySelector() en querySelectorAll() zijn instantiemethoden van Element. Beide nemen één tekenreeks met een CSS-selector of een door komma’s gescheiden lijst van CSS-selectors. querySelector() geeft het eerste passende element in documentvolgorde terug, of null. querySelectorAll() geeft een statische NodeList met alle passende elementen in dezelfde volgorde terug: ouders vóór afstammelingen en eerdere elementen met dezelfde ouder vóór latere. De volgorde van de selectors bepaalt geen voorrang en elk element staat hoogstens één keer in het resultaat. Zonder overeenkomsten is de lijst leeg (length === 0).
Alleen afstammelingen van het element waarop je de methode aanroept kunnen in het resultaat staan, nooit het element zelf. Of een selector past, kan wel afhangen van voorouders buiten die deelboom. :scope verwijst naar het element waarop je de methode aanroept. Daardoor selecteert :scope > .item alleen de directe kinderen met de klasse item. Zoekopdrachten gaan niet over de grenzen van de shadow DOM heen. Roep de methode op een toegankelijke ShadowRoot aan om daarbinnen te zoeken.
Een statische lijst behoudt de elementen en hun volgorde van het moment van aanroepen. Een klasse wijzigen of een element toevoegen, verwijderen of verplaatsen werkt de lijst niet bij. De items verwijzen nog steeds naar de oorspronkelijke Element-objecten, niet naar kopieën. Voer de zoekopdracht opnieuw uit voor een actueel resultaat en gebruik Array.from(list) als je arraymethoden nodig hebt.
Bij een ongeldige selectortekenreeks gooien beide methoden een DOMException met de naam SyntaxError. Dat is iets anders dan geen overeenkomsten vinden. CSS-pseudo-elementen zoals ::before worden niet als DOM-elementen teruggegeven. Voeg een dynamische ID in met "#" + CSS.escape(id) om de CSS-identificator te escapen, niet de hele selector of HTML. Deze methoden horen bij het DOM van het webplatform, niet bij ECMAScript 2024. Controleer of de doelomgeving het DOM en de selectors ondersteunt.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element selector queries</title>
</head>
<body>
<script>
const frame = document.createElement("div");
frame.className = "frame";
const root = frame.appendChild(document.createElement("section"));
const direct = root.appendChild(document.createElement("p"));
const wrapper = root.appendChild(document.createElement("div"));
const nested = wrapper.appendChild(document.createElement("p"));
direct.className = nested.className = "item";
direct.textContent = "A";
nested.textContent = "B";
const snapshot = root.querySelectorAll(".frame .item");
console.log(root.querySelector(":scope > .item").textContent);
console.log(snapshot.length);
console.log(root.querySelectorAll(":scope > .item").length);
nested.remove();
console.log(`${snapshot.length} ${root.querySelectorAll(".frame .item").length}`);
</script>
</body>
</html>Resultaat
A 2 1 2 1
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. `:scope > .item` vindt alleen `A`, terwijl `.frame .item` beide alinea’s vindt via een voorouder buiten `root`. Na het verwijderen van `B` bevat de bewaarde lijst nog twee items, maar de nieuwe zoekopdracht levert er één op.
Gerelateerde lessen
- JavaScript · Les 30 · Gevorderd · Versie: 4