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

CKTIS / JavaScript

Element.querySelectorAll — vyhledávání potomků

Element.querySelectorAll vrací statický NodeList potomků, kteří odpovídají selektoru CSS. Pozdější změny stromu tento seznam neaktualizují.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.querySelectorAll(selectors)

Element.querySelectorAll(selectors) vrací odpovídající potomky v pořadí stromu jako NodeList, nikoli jako pole. Samotný volající element se do výsledku nezahrnuje. Pokud nejsou žádné shody, je seznam prázdný; querySelector místo toho vrací první element nebo null.

Seznam je statický: změny stromu neaktualizují jeho obsah, ale obsažené elementy nejsou kopie. Nové volání vrátí aktuální výsledky. Neplatný selektor vyvolá DOMException s názvem SyntaxError.

Selektor může zohlednit předky mimo volající element; pro výběr přímých potomků použijte :scope > .item. Jde o DOM API, nikoli o funkci ECMAScriptu; samotná dostupnost Node.js nedokládá podporu.

Příklady

const root = document.createElement('section');
const first = document.createElement('span');
first.className = 'item';
root.append(first);

const matches = root.querySelectorAll('.item');
const second = document.createElement('span');
second.className = 'item';
root.append(second);

console.log(matches.length);
console.log(root.querySelectorAll('.item').length);
console.log(matches[0] === first);

Výsledek

1
2
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje