CKTIS / JavaScript
Element.querySelectorAll — vyhľadávanie potomkov
Element.querySelectorAll vracia statický NodeList potomkov, ktorí zodpovedajú selektoru CSS. Neskoršie zmeny stromu tento zoznam neaktualizujú.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) vracia zodpovedajúcich potomkov v poradí stromu ako NodeList, nie ako pole. Samotný volajúci element nie je súčasťou výsledku. Ak sa nenájdu žiadne zhody, zoznam je prázdny; querySelector namiesto toho vráti prvý element alebo null.
Zoznam je statický: zmeny stromu neaktualizujú jeho obsah, ale obsiahnuté elementy nie sú kópie. Nové volanie vráti aktuálne výsledky. Neplatný selektor vyvolá DOMException s názvom SyntaxError.
Selektor môže zohľadniť predkov mimo volajúceho elementu; na výber priamych potomkov použite :scope > .item. Ide o DOM API, nie o funkciu ECMAScriptu; samotná dostupnosť Node.js nedokazuje podporu.
Prí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ýsledok
1 2 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.