Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Element.querySelector() i Element.querySelectorAll()

Pronađi potomke elementa pomoću CSS selektora i odaberi prvo podudaranje ili statičan popis svih podudaranja.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

element.querySelector(selectors)     // Element | null
element.querySelectorAll(selectors)  // static NodeList of Element objects

querySelector() i querySelectorAll() metode su instance sučelja Element. Svaka prima jedan niz znakova s CSS selektorom ili popisom CSS selektora odvojenih zarezima. querySelector() vraća prvi element koji odgovara selektoru prema redoslijedu u dokumentu ili null. querySelectorAll() vraća statičan NodeList svih elemenata koji odgovaraju, istim redoslijedom: roditelji prije potomaka, a raniji elementi s istim roditeljem prije kasnijih. Redoslijed selektora ne određuje prednost i svaki se element pojavljuje najviše jednom. Ako nema podudaranja, popis je prazan (length === 0).

Rezultat može sadržavati samo potomke elementa na kojem pozivaš metodu, nikada sam taj element. Podudaranje ipak može ovisiti o precima izvan tog podstabla. :scope označava element na kojem pozivaš metodu pa :scope > .item odabire samo njegovu izravnu djecu s klasom item. Upiti ne prelaze granice shadow DOM-a. Za pretraživanje unutar njega pozovi metodu na dostupnom objektu ShadowRoot.

Statičan popis zadržava stavke i njihov redoslijed iz trenutka poziva. Promjena klase ili dodavanje, uklanjanje ili premještanje elementa ne ažurira popis. Njegove stavke i dalje upućuju na izvorne objekte Element, a ne na kopije. Ponovi upit za ažuran rezultat. Ako trebaš metode za polja, upotrijebi Array.from(list).

Ako je niz selektora neispravan, obje metode izbacuju iznimku DOMException naziva SyntaxError. To nije isto što i izostanak podudaranja. CSS pseudoelementi kao što je ::before ne vraćaju se kao elementi DOM-a. Za umetanje dinamičkog ID-ja u selektor upotrijebi "#" + CSS.escape(id) da zaštitiš sintaksu CSS identifikatora, a ne cijelog selektora ili HTML-a. Metode pripadaju DOM-u web-platforme, a ne ECMAScriptu 2024. Provjeri podršku za DOM i selektore u ciljanom okruženju.

Primjeri

<!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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli preglednika. `:scope > .item` pronalazi samo `A`, dok `.frame .item` pronalazi oba odlomka zahvaljujući pretku izvan `root`. Nakon uklanjanja `B` spremljeni popis i dalje ima dvije stavke, ali novi upit vraća jednu.

Povezane lekcije

  • JavaScript · Lekcija 30 · Napredno · Verzija: 4

Izvori