База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Element.querySelector() и Element.querySelectorAll()

Намери потомци на елемент чрез CSS селектори. Избери първото съвпадение или получи статичен списък с всички съвпадения.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

querySelector() и querySelectorAll() са методи на екземпляр на Element. Всеки приема един низ с CSS селектор или списък от CSS селектори, разделени със запетаи. querySelector() връща първия съвпадащ елемент по реда в документа или null. querySelectorAll() връща статичен NodeList с всички съвпадащи елементи в същия ред: родителите преди потомците, а по-ранните елементи с общ родител преди по-късните. Редът на селекторите не определя приоритет и всеки елемент се появява най-много веднъж. Ако няма съвпадения, списъкът е празен (length === 0).

Резултатът може да съдържа само потомци на елемента, върху който извикваш метода, но не и самия елемент. При съпоставянето обаче могат да участват предци извън това поддърво. :scope обозначава елемента, върху който извикваш метода, затова :scope > .item избира само преките му деца с клас item. Заявките не преминават през границите на shadow DOM. За да търсиш вътре, извикай метода върху достъпен ShadowRoot.

Статичният списък запазва елементите и реда им от момента на извикването. Промяна на клас или добавяне, премахване или преместване на елемент не обновява списъка. Позициите в него продължават да сочат към оригиналните обекти Element, а не към техни копия. Изпълни заявката отново за актуален резултат. Ако ти трябват методите на масивите, използвай Array.from(list).

При невалиден низ на селектора и двата метода хвърлят DOMException с име SyntaxError. Това е различно от липса на съвпадения. CSS псевдоелементи като ::before не се връщат като DOM елементи. За вмъкване на динамично ID в селектор използвай "#" + CSS.escape(id): така екранираш CSS идентификатора, а не целия селектор или HTML. Тези методи са част от DOM на уеб платформата, а не от ECMAScript 2024. Провери поддръжката на DOM и селекторите в целевата среда за изпълнение.

Примери

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

Резултат

A
2
1
2 1

Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата на браузъра. `:scope > .item` намира само `A`, докато `.frame .item` намира и двата абзаца благодарение на предшественик извън `root`. След премахването на `B` запазеният списък продължава да съдържа две позиции, но новата заявка връща една.

Свързани уроци

  • JavaScript · Урок 30 · Напреднало · Версия: 4

Източници