KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Range — een live bereik in de DOM-boom

Range beschrijft een fragment van de DOM tussen twee grenzen. Het kan inhoud uitnemen, verwijderen en invoegen; de grenzen reageren automatisch op wijzigingen in de boom.

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 range = document.createRange();
range.setStart(node, startOffset);
range.setEnd(node, endOffset);
range.extractContents();
range.insertNode(node);

Range is een live bereik dat wordt gedefinieerd door twee combinaties van knoop en offset. Maak het met document.createRange() of new Range(). Het is een Web-API uit de DOM-standaard, geen functie van een bepaalde ECMAScript-editie; de aanwezigheid van Node 24 in een repository bewijst niet dat de API beschikbaar is. Het voorbeeld vereist een browser-DOM.

Range.startOffset en Range.endOffset tellen UTF-16-code-eenheden in CharacterData, maar tellen in elementen onderliggende knopen in plaats van tekens. Range.commonAncestorContainer geeft de diepste gedeelde knoop terug die beide grenzen bevat; dat kan de tekstknoop zelf zijn. Range.collapsed betekent dat de grenzen identiek zijn, niet alleen dat de tekst leeg is.

Range.extractContents() verwijdert inhoud en geeft een DocumentFragment terug: volledig omvatte knopen worden verplaatst, terwijl gedeeltelijk omvatte structuren zo nodig worden gekopieerd. Range.deleteContents() verwijdert inhoud zonder een fragment terug te geven. Beide bewerkingen laten het bereik samenvallen. Range.insertNode(node) voegt in aan het begin in plaats van inhoud te vervangen; het kan een tekstknoop splitsen en een samengevallen bereik uitbreiden.

Range.setStartAfter(node) plaatst het begin na de knoop in de bovenliggende knoop; de knoop moet een bovenliggende knoop hebben. Range.collapse(true) laat het bereik samenvallen met het begin, terwijl Range.collapse(false) of Range.collapse() het laat samenvallen met het einde. Range.cloneRange() maakt een afzonderlijk live bereik met dezelfde grenzen, geen DOM-kopie of onveranderlijke momentopname: latere wijzigingen kunnen beide bereiken beïnvloeden.

Voorbeelden

(() => {
  const host = document.createElement('div');
  host.textContent = 'ABCDE';
  const range = document.createRange();
  range.setStart(host.firstChild, 1);
  range.setEnd(host.firstChild, 4);
  console.log(range.commonAncestorContainer === host.firstChild);
  console.log(range.startOffset, range.endOffset, range.collapsed);

  const copy = range.cloneRange();
  copy.collapse(true);
  console.log(copy.collapsed, range.collapsed);

  const fragment = range.extractContents();
  console.log(fragment.textContent, host.textContent, range.collapsed);
  const mark = document.createElement('mark');
  mark.appendChild(fragment);
  range.insertNode(mark);
  range.setStartAfter(mark);
  range.collapse(true);
  console.log(host.textContent, range.startOffset, range.endOffset);

  range.selectNode(mark);
  range.deleteContents();
  console.log(host.textContent, range.collapsed);
})();

Resultaat

true
1 4 false
true false
BCD AE true
ABCDE 2 2
AE 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