Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element.querySelector() a Element.querySelectorAll()

Vyhledej potomky prvku pomocí selektorů CSS. Získej první odpovídající prvek nebo statický seznam všech odpovídajících prvků.

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

Syntaxe

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

querySelector() a querySelectorAll() jsou instanční metody rozhraní Element. Každá přijímá jeden řetězec se selektorem CSS nebo se seznamem selektorů CSS oddělených čárkami. querySelector() vrací první odpovídající prvek v pořadí dokumentu, nebo null. querySelectorAll() vrací statický seznam NodeList všech odpovídajících prvků ve stejném pořadí: rodiče před potomky, dřívější sourozenci před pozdějšími. Pořadí selektorů neurčuje prioritu a každý prvek je ve výsledku nejvýše jednou. Pokud nic neodpovídá, seznam je prázdný (length === 0).

Výsledek může obsahovat jen potomky prvku, na němž metodu voláš, nikdy samotný prvek. Při vyhodnocování selektoru se přesto mohou zohlednit předci mimo tento podstrom. :scope označuje prvek, na němž metodu voláš, takže :scope > .item vybírá jen jeho přímé potomky se třídou item. Dotazy nepřekračují hranice shadow DOM. Chceš-li hledat uvnitř, zavolej metodu na dostupném objektu ShadowRoot.

Statický seznam si ponechává položky i jejich pořadí z okamžiku volání. Změna třídy ani přidání, odstranění či přesunutí prvku seznam neaktualizuje. Jeho položky stále odkazují na původní objekty Element, nikoli na kopie. Pro aktuální výsledek dotaz zopakuj. Pokud potřebuješ metody polí, použij Array.from(list).

Neplatný řetězec selektoru vyvolá u obou metod výjimku DOMException s názvem SyntaxError. To není totéž jako nenajít žádný odpovídající prvek. Pseudoprvky CSS, například ::before, se nevracejí jako prvky DOM. Pro vložení dynamického ID do selektoru použij "#" + CSS.escape(id): ošetříš tím identifikátor CSS, nikoli celý selektor ani HTML. Tyto metody patří k DOM webové platformy, ne k ECMAScriptu 2024. Ověř si podporu DOM a používaných selektorů v cílovém prostředí.

Příklady

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

Výsledek

A
2
1
2 1

Ulož příklad jako soubor HTML, otevři jej v prohlížeči a zkontroluj výstup v konzoli prohlížeče. `:scope > .item` najde pouze `A`, zatímco `.frame .item` najde oba odstavce díky předkovi mimo `root`. Po odstranění `B` má uložený seznam stále dvě položky, ale nový dotaz vrátí jednu.

Související lekce

  • JavaScript · Lekce 30 · Pokročilá · Verze: 4

Zdroje