Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.querySelector() i Element.querySelectorAll()

Wyszukuj potomków elementu za pomocą selektorów CSS. Wybierz pierwsze dopasowanie albo pobierz statyczną listę wszystkich dopasowań.

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

Składnia

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

querySelector() i querySelectorAll() to metody instancji Element. Każda przyjmuje jeden ciąg zawierający selektor CSS lub listę selektorów CSS rozdzielonych przecinkami. querySelector() zwraca pierwszy pasujący element w kolejności dokumentu albo null. querySelectorAll() zwraca statyczną NodeList wszystkich pasujących elementów w tej samej kolejności: rodzice przed potomkami, wcześniejsze rodzeństwo przed późniejszym. Kolejność selektorów na liście nie ustala priorytetu, a każdy element pojawia się najwyżej raz. Przy braku dopasowań lista jest pusta (length === 0).

Wyniki obejmują tylko potomków elementu, na którym wywołano metodę, nigdy jego samego. Przy dopasowywaniu selektor może jednak uwzględniać przodków spoza tego poddrzewa. :scope wskazuje element, na którym wywołano metodę, więc :scope > .item wybiera tylko jego bezpośrednie dzieci z klasą item. Wyszukiwanie nie przekracza granicy shadow DOM; aby przeszukać jego wnętrze, wywołaj metodę na dostępnym ShadowRoot.

Statyczna lista zachowuje skład i kolejność z chwili wywołania. Zmiana klasy, dodanie, usunięcie lub przeniesienie elementu nie aktualizuje listy. Jej pozycje nadal wskazują oryginalne obiekty Element, a nie ich kopie. Ponów zapytanie, aby uzyskać aktualny wynik; jeśli potrzebujesz metod tablicowych, użyj Array.from(list).

Nieprawidłowy ciąg selektora powoduje w obu metodach wyjątek DOMException o nazwie SyntaxError; to nie to samo co brak dopasowań. Pseudoelementy CSS, takie jak ::before, nie są zwracane jako elementy DOM. Gdy wstawiasz dynamiczny identyfikator do selektora, użyj "#" + CSS.escape(id): zabezpieczasz w ten sposób składnię identyfikatora CSS, nie cały selektor ani HTML. Metody należą do DOM platformy webowej, a nie do ECMAScript 2024. Sprawdź obsługę DOM i używanych selektorów w docelowym środowisku.

Przykłady

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

Wynik

A
2
1
2 1

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. `:scope > .item` znajduje tylko `A`, a `.frame .item` dopasowuje oba akapity, uwzględniając przodka poza `root`. Po usunięciu `B` zapisana lista nadal ma dwie pozycje, ale nowe zapytanie zwraca jedną.

Powiązane lekcje

  • JavaScript · Lekcja 30 · Zaawansowany · Wersja: 4

Źródła