CKTIS / JavaScript
Range — živý rozsah ve stromu DOM
Range popisuje část DOM mezi dvěma hranicemi. Umožňuje obsah vyjmout, odstranit a vložit, přičemž jeho hranice automaticky reagují na změny ve stromu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const range = document.createRange();
range.setStart(node, startOffset);
range.setEnd(node, endOffset);
range.extractContents();
range.insertNode(node);Range je živý rozsah určený dvěma dvojicemi uzel a offset. Vytvoříte jej pomocí document.createRange() nebo new Range(). Jde o webové API standardu DOM, nikoli o funkci konkrétní edice ECMAScriptu; přítomnost Node 24 v repozitáři nedokazuje jeho dostupnost. Příklad vyžaduje DOM v prohlížeči.
Range.startOffset a Range.endOffset počítají jednotky kódu UTF-16 v CharacterData, ale v elementech počítají podřízené uzly, nikoli znaky. Range.commonAncestorContainer vrací nejhlubší společný uzel, který obsahuje obě hranice; může jít o samotný textový uzel. Range.collapsed znamená, že hranice jsou totožné, nikoli pouze to, že je text prázdný.
Range.extractContents() odstraní obsah a vrátí DocumentFragment: plně zahrnuté uzly přesune, zatímco částečně zahrnuté struktury podle potřeby zkopíruje. Range.deleteContents() odstraní obsah, aniž by vrátil fragment. Obě operace rozsah zhroutí. Range.insertNode(node) vloží uzel na začátek, místo aby obsah nahradil; může rozdělit textový uzel a rozšířit zhroucený rozsah.
Range.setStartAfter(node) nastaví začátek za uzel v jeho rodiči; uzel musí mít rodiče. Range.collapse(true) zhroutí rozsah na začátek, zatímco Range.collapse(false) nebo Range.collapse() jej zhroutí na konec. Range.cloneRange() vytvoří samostatný živý rozsah se stejnými hranicemi, nikoli kopii DOM ani neměnný snímek: pozdější změny mohou ovlivnit oba rozsahy.
Příklady
(() => {
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);
})();Výsledek
true 1 4 false true false BCD AE true ABCDE 2 2 AE true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.