Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Range — živý rozsah v strome DOM

Range opisuje časť DOM medzi dvoma hranicami. Umožňuje obsah vyňať, odstrániť a vložiť, pričom jeho hranice automaticky reagujú na zmeny v strome.

Verzia: 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 je živý rozsah určený dvoma dvojicami uzol a offset. Vytvoríte ho pomocou document.createRange() alebo new Range(). Ide o webové API štandardu DOM, nie o funkciu konkrétnej edície ECMAScriptu; prítomnosť Node 24 v repozitári nedokazuje jeho dostupnosť. Príklad vyžaduje DOM v prehliadači.

Range.startOffset a Range.endOffset počítajú jednotky kódu UTF-16 v CharacterData, ale v elementoch počítajú podriadené uzly, nie znaky. Range.commonAncestorContainer vracia najhlbší spoločný uzol, ktorý obsahuje obe hranice; môže ísť o samotný textový uzol. Range.collapsed znamená, že hranice sú totožné, nie iba to, že text je prázdny.

Range.extractContents() odstráni obsah a vráti DocumentFragment: úplne zahrnuté uzly presunie, zatiaľ čo čiastočne zahrnuté štruktúry podľa potreby skopíruje. Range.deleteContents() odstráni obsah bez vrátenia fragmentu. Obe operácie rozsah zrúbia. Range.insertNode(node) vloží uzol na začiatok namiesto nahradenia obsahu; môže rozdeliť textový uzol a rozšíriť zrútený rozsah.

Range.setStartAfter(node) nastaví začiatok za uzol v jeho rodičovi; uzol musí mať rodiča. Range.collapse(true) zrúti rozsah na začiatok, zatiaľ čo Range.collapse(false) alebo Range.collapse() ho zrúti na koniec. Range.cloneRange() vytvorí samostatný živý rozsah s rovnakými hranicami, nie kópiu DOM ani nemennú snímku: neskoršie zmeny môžu ovplyvniť oba rozsahy.

Prí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ýsledok

true
1 4 false
true false
BCD AE true
ABCDE 2 2
AE true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje