CKTIS / JavaScript
document.querySelectorAll — vsi ujemajoči se elementi
Išče elemente z izbirniki CSS in vrne statični NodeList, tudi kadar ni nobenega ujemanja.
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
document.querySelectorAll(selectors)document.querySelectorAll(selectors) vrne statični NodeList ujemajočih se elementov v vrstnem redu drevesa dokumenta. Argument je niz izbirnika CSS, lahko tudi seznam, ločen z vejicami.
Če ni ujemanj, vrne prazen seznam, ne null. Neveljaven izbirnik sproži DOMException z imenom SyntaxError. Nasprotno pa document.querySelector(selectors) vrne prvi ujemajoči se element ali null.
Statični seznam ohrani svoje elemente tudi po spremembah DOM; elementov ne kopira. Za posodobljene rezultate poizvedbo izvedite znova. Primer uporablja ločen dokument, zato odprte strani ne spremeni.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document.querySelectorAll</title>
</head>
<body>
<h1>All matching elements</h1>
<ul id="items">
<li class="item">First item</li>
</ul>
<script>
const matches = document.querySelectorAll('.item');
const added = document.createElement('li');
added.className = 'item';
added.textContent = 'Second item';
document.getElementById('items').append(added);
console.log(matches.length);
console.log(document.querySelectorAll('.item').length);
console.log(document.querySelectorAll('.missing').length);
</script>
</body>
</html>Rezultat
1 2 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.