CKTIS / JavaScript
Element.querySelector() in Element.querySelectorAll()
Poišči potomce elementa z izbirniki CSS. Izberi prvo ujemanje ali pridobi statični seznam vseh ujemanj.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.querySelector(selectors) // Element | null
element.querySelectorAll(selectors) // static NodeList of Element objectsquerySelector() in querySelectorAll() sta metodi primerka vmesnika Element. Obe sprejmeta en niz z izbirnikom CSS ali seznamom izbirnikov CSS, ločenih z vejicami. querySelector() vrne prvi ujemajoči se element v vrstnem redu dokumenta ali null. querySelectorAll() vrne statični NodeList vseh ujemajočih se elementov v istem vrstnem redu: starši pred potomci, zgodnejši sorojenci pred poznejšimi. Vrstni red izbirnikov ne določa prednosti in vsak element se pojavi največ enkrat. Če ni ujemanj, je seznam prazen (length === 0).
Rezultat lahko vsebuje le potomce elementa, na katerem pokličeš metodo, nikoli pa tega elementa samega. Ujemanje je vseeno lahko odvisno od prednikov zunaj tega poddrevesa. :scope označuje element, na katerem pokličeš metodo, zato :scope > .item izbere le njegove neposredne otroke z razredom item. Poizvedbe ne prečkajo meja senčnega DOM-a. Za iskanje znotraj njega pokliči metodo na dostopnem objektu ShadowRoot.
Statični seznam ohrani postavke in njihov vrstni red iz trenutka klica. Seznam se ne posodobi, če spremeniš razred ali dodaš, odstraniš oziroma premakneš element. Postavke se še vedno sklicujejo na prvotne objekte Element, ne na kopije. Za svež rezultat ponovi poizvedbo. Če potrebuješ metode polj, uporabi Array.from(list).
Če je niz izbirnika neveljaven, obe metodi sprožita izjemo DOMException z imenom SyntaxError. To ni isto kot poizvedba brez ujemanj. Psevdoelementi CSS, kot je ::before, se ne vrnejo kot elementi DOM-a. Za vstavljanje dinamičnega ID-ja v izbirnik uporabi "#" + CSS.escape(id): ubežno zapišeš identifikator CSS, ne celotnega izbirnika ali kode HTML. Metodi sta del DOM-a spletne platforme in ne standarda ECMAScript 2024. Preveri podporo za DOM in izbirnike v ciljnem izvajalnem okolju.
Primeri
<!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>Rezultat
A 2 1 2 1
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli brskalnika. `:scope > .item` najde le `A`, medtem ko `.frame .item` najde oba odstavka zaradi prednika zunaj `root`. Po odstranitvi `B` ima shranjeni seznam še vedno dve postavki, nova poizvedba pa vrne eno.
Povezane lekcije
- JavaScript · Lekcija 30 · Napredna · Različica: 4