CKTIS / JavaScript
Element.querySelector() a Element.querySelectorAll()
Vyhľadaj potomkov prvku pomocou selektorov CSS. Získaj prvý zodpovedajúci prvok alebo statický zoznam všetkých zodpovedajúcich prvkov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.querySelector(selectors) // Element | null
element.querySelectorAll(selectors) // static NodeList of Element objectsquerySelector() a querySelectorAll() sú inštančné metódy rozhrania Element. Každá prijíma jeden reťazec so selektorom CSS alebo so zoznamom selektorov CSS oddelených čiarkami. querySelector() vráti prvý zodpovedajúci prvok v poradí dokumentu alebo null. querySelectorAll() vráti statický zoznam NodeList všetkých zodpovedajúcich prvkov v rovnakom poradí: rodičia pred potomkami, skorší súrodenci pred neskoršími. Poradie selektorov neurčuje prioritu a každý prvok je vo výsledku najviac raz. Ak nič nezodpovedá, zoznam je prázdny (length === 0).
Výsledok môže obsahovať len potomkov prvku, na ktorom metódu voláš, nikdy nie samotný prvok. Pri vyhodnocovaní selektora však môžu zavážiť aj predkovia mimo tohto podstromu. :scope označuje prvok, na ktorom metódu voláš, takže :scope > .item vyberá len jeho priamych potomkov s triedou item. Dopyty neprekračujú hranice shadow DOM. Ak chceš vyhľadávať vnútri, zavolaj metódu na dostupnom objekte ShadowRoot.
Statický zoznam si zachová položky aj ich poradie z okamihu volania. Zmena triedy ani pridanie, odstránenie či presunutie prvku zoznam neaktualizuje. Jeho položky stále odkazujú na pôvodné objekty Element, nie na kópie. Ak chceš aktuálny výsledok, zopakuj dopyt. Ak potrebuješ metódy poľa, použi Array.from(list).
Neplatný reťazec selektora vyvolá pri oboch metódach výnimku DOMException s názvom SyntaxError. To nie je to isté ako nenájsť žiadny zodpovedajúci prvok. Pseudoprvky CSS, napríklad ::before, sa nevracajú ako prvky DOM. Ak vkladáš dynamické ID do selektora, použi "#" + CSS.escape(id). Tým ošetríš identifikátor CSS, nie celý selektor ani HTML. Tieto metódy patria do DOM webovej platformy, nie do ECMAScriptu 2024. Over podporu DOM a použitých selektorov v cieľovom prostredí.
Prí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ýsledok
A 2 1 2 1
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup v konzole prehliadača. `:scope > .item` nájde iba `A`, kým `.frame .item` nájde oba odseky vďaka predkovi mimo `root`. Po odstránení `B` má uložený zoznam stále dve položky, ale nový dopyt vráti jednu.
Súvisiace lekcie
- JavaScript · Lekcia 30 · Pokročilá · Verzia: 4