CKTIS / JavaScript
document.querySelectorAll — všechny odpovídající prvky
Vyhledává prvky pomocí CSS selektorů a vrací statický NodeList, i když žádné prvky neodpovídají.
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
document.querySelectorAll(selectors)document.querySelectorAll(selectors) vrací statický NodeList odpovídajících prvků v pořadí stromu dokumentu. Argumentem je řetězec CSS selektoru, případně seznam oddělený čárkami.
Pokud žádné prvky neodpovídají, výsledkem je prázdný seznam, nikoli null. Neplatný selektor vyvolá DOMException s názvem SyntaxError. Naproti tomu document.querySelector(selectors) vrací první odpovídající prvek nebo null.
Statický seznam si zachovává své prvky i po změnách DOM; prvky nekopíruje. Chcete-li aktuální výsledky, spusťte dotaz znovu. Příklad používá samostatný dokument, takže otevřenou stránku nemění.
Příklady
<!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>Výsledek
1 2 0
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.