База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Range — жив диапазон в DOM дървото

Range описва фрагмент от DOM между две граници. Позволява извличане, изтриване и вмъкване на съдържание, а границите му автоматично реагират на промени в дървото.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

Range е жив диапазон, зададен чрез две двойки възел и отместване. Създава се с document.createRange() или new Range(). Това е Web API от стандарта DOM, а не функция на конкретно издание на ECMAScript; наличието на Node 24 в хранилище не доказва, че API е достъпен. Примерът изисква DOM в браузър.

Range.startOffset и Range.endOffset броят UTF-16 кодови единици в CharacterData, а в елементите броят дъщерни възли, не знаци. Range.commonAncestorContainer връща най-дълбокия общ възел, който съдържа и двете граници; това може да е самият текстов възел. Range.collapsed означава, че границите са еднакви, а не просто че текстът е празен.

Range.extractContents() премахва съдържание и връща DocumentFragment: изцяло включените възли се преместват, а частично включените структури се копират при необходимост. Range.deleteContents() премахва съдържание, без да връща фрагмент. И двете операции свиват диапазона. Range.insertNode(node) вмъква в началото, вместо да заменя съдържанието; може да раздели текстов възел и да разшири свит диапазон.

Range.setStartAfter(node) задава началото след възела в неговия родител; възелът трябва да има родител. Range.collapse(true) свива диапазона до началото, а Range.collapse(false) или Range.collapse() — до края. Range.cloneRange() създава отделен жив диапазон със същите граници, а не копие на DOM или неизменна моментна снимка: последващи промени могат да засегнат и двата диапазона.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници