Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.querySelectorAll — iskanje potomcev

Element.querySelectorAll vrne statični NodeList potomcev, ki ustrezajo izbirniku CSS. Poznejše spremembe drevesa seznama ne posodobijo.

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

Sintaksa

element.querySelectorAll(selectors)

Element.querySelectorAll(selectors) vrne ustrezne potomce v vrstnem redu drevesa kot NodeList, ne kot polje. Klicni element sam ni vključen. Če ni ujemanj, je seznam prazen; querySelector namesto tega vrne prvi element ali null.

Seznam je statičen: spremembe drevesa ne posodobijo njegove vsebine, vendar vključeni elementi niso kopije. Nov klic vrne trenutne rezultate. Neveljaven izbirnik sproži DOMException z imenom SyntaxError.

Izbirnik lahko upošteva prednike zunaj klicnega elementa; za izbiro neposrednih otrok uporabi :scope > .item. To je API DOM, ne funkcija ECMAScripta; sama razpoložljivost Node.js še ne dokazuje podpore.

Primeri

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);

Rezultat

1
2
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri