KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

document.querySelectorAll — alle overeenkomende elementen

Zoekt elementen met CSS-selectors en geeft een statische NodeList terug, ook als er geen overeenkomsten zijn.

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

Syntax

document.querySelectorAll(selectors)

document.querySelectorAll(selectors) geeft een statische NodeList van de overeenkomende elementen terug, in de volgorde van de documentboom. Het argument is een CSS-selectorstring, eventueel een door komma’s gescheiden lijst.

Zijn er geen overeenkomsten, dan is het resultaat een lege lijst, geen null. Een ongeldige selector veroorzaakt een DOMException met de naam SyntaxError. Daarentegen geeft document.querySelector(selectors) het eerste overeenkomende element of null terug.

Een statische lijst behoudt dezelfde elementen na wijzigingen aan de DOM; de elementen worden niet gekopieerd. Voer de query opnieuw uit voor bijgewerkte resultaten. Het voorbeeld gebruikt een apart document en verandert de geopende pagina dus niet.

Voorbeelden

<!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>

Resultaat

1
2
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen