Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Range — żywy zakres w drzewie DOM

Range opisuje fragment DOM między dwiema granicami. Pozwala wycinać, usuwać i wstawiać zawartość, a jego granice automatycznie reagują na zmiany drzewa.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const range = document.createRange();
range.setStart(node, startOffset);
range.setEnd(node, endOffset);
range.extractContents();
range.insertNode(node);

Range to żywy zakres wyznaczony przez dwie pary: węzeł i przesunięcie. Utworzysz go przez document.createRange() lub new Range(). To Web API standardu DOM, nie funkcja konkretnej edycji ECMAScript; Node 24 w repozytorium nie dowodzi jego dostępności. Przykład wymaga przeglądarkowego DOM.

Range.startOffset i Range.endOffset liczą jednostki UTF-16 w CharacterData, a w elementach — węzły potomne, nie znaki. Range.commonAncestorContainer zwraca najgłębszy wspólny węzeł obejmujący obie granice; może to być sam węzeł tekstowy. Range.collapsed oznacza identyczne granice, nie tylko pusty tekst.

Range.extractContents() usuwa zawartość i zwraca DocumentFragment: przenosi całkowicie objęte węzły, a częściowo objęte struktury kopiuje w potrzebnym zakresie. Range.deleteContents() usuwa bez zwracania fragmentu. Obie operacje zwijają zakres. Range.insertNode(node) wstawia na początku, nie zastępuje zawartości; może rozdzielić węzeł tekstowy i rozwinąć zwinięty zakres.

Range.setStartAfter(node) ustawia początek za węzłem w jego rodzicu; węzeł musi mieć rodzica. Range.collapse(true) zwija do początku, a Range.collapse(false) lub Range.collapse() — do końca. Range.cloneRange() tworzy osobny żywy zakres o tych samych granicach, nie kopię DOM ani niezmienny zapis: późniejsze mutacje mogą zmieniać oba zakresy.

Przykłady

(() => {
  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);
})();

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła