KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Selection — documentselectie

Selection staat voor de selectie in het document. Lees over rangeCount en hoe je met addRange een bereik toevoegt.

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

const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);

Selection staat voor de selectie in het document; Range bepaalt de grenzen ervan. Haal de selectie op met window.getSelection() en controleer of het resultaat null is. Dit is een Web API, geen ECMAScript-functie; Node 24 toont geen browserondersteuning aan.

Selection.rangeCount is alleen-lezen: volgens de specificatie is de waarde 0 als de selectie leeg is of de grenzen buiten de documentboom liggen, en anders 1. Een samengevouwen bereik kan nog steeds 1 opleveren — dat betekent niet dat er tekst is geselecteerd.

Wanneer Selection.addRange(range) een bereik toevoegt, bewaart de methode een verwijzing, geen kopie. Volgens de specificatie doet de methode niets als het bereik buiten de documentboom ligt of als Selection.rangeCount niet gelijk is aan 0. In Firefox kun je echter meerdere bereiken toevoegen, waardoor Selection.rangeCount daar groter kan zijn dan 1. Ga er niet van uit dat alle browsers meerdere bereiken ondersteunen. Wil je de selectie vervangen, roep dan removeAllRanges() aan voordat je het nieuwe bereik toevoegt.

Voorbeelden

(() => {
  const selection = window.getSelection();
  if (!selection || !document.body) {
    throw new Error('An active browser document with a body is required.');
  }

  const paragraph = document.createElement('p');
  paragraph.textContent = 'Hello Selection';
  document.body.append(paragraph);

  const range = document.createRange();
  range.setStart(paragraph.firstChild, 6);
  range.setEnd(paragraph.firstChild, 15);

  try {
    selection.removeAllRanges();
    selection.addRange(range);
    console.log(selection.rangeCount + ': ' + selection.toString());

    range.collapse(true);
    console.log(selection.rangeCount + ': ' + selection.isCollapsed);
  } finally {
    selection.removeAllRanges();
    paragraph.remove();
  }
})();

Resultaat

1: Selection
1: true

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