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.