CKTIS / JavaScript
document.querySelectorAll — tutti gli elementi corrispondenti
Cerca elementi usando selettori CSS e restituisce una NodeList statica, anche quando non ci sono corrispondenze.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
document.querySelectorAll(selectors)document.querySelectorAll(selectors) restituisce una NodeList statica degli elementi corrispondenti, nell’ordine dell’albero del documento. L’argomento è una stringa con un selettore CSS, che può anche essere un elenco separato da virgole.
Se non ci sono corrispondenze, il risultato è un elenco vuoto, non null. Un selettore non valido genera una DOMException denominata SyntaxError. Al contrario, document.querySelector(selectors) restituisce il primo elemento corrispondente oppure null.
Un elenco statico mantiene gli stessi elementi anche dopo le modifiche al DOM; non ne crea copie. Esegui di nuovo la query per ottenere risultati aggiornati. L’esempio usa un documento separato e quindi non modifica la pagina aperta.
Esempi
<!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>Risultato
1 2 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.