Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Range — živi raspon u stablu DOM-a

Range opisuje dio DOM-a između dviju granica. Omogućuje izdvajanje, brisanje i umetanje sadržaja, a njegove granice automatski reagiraju na promjene stabla.

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

Sintaksa

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

Range je živi raspon definiran s dva para čvor i pomak. Stvara se pomoću document.createRange() ili new Range(). To je web-API standarda DOM, a ne značajka određenog izdanja ECMAScripta; prisutnost Nodea 24 u repozitoriju ne dokazuje da je API dostupan. Primjer zahtijeva DOM u pregledniku.

Range.startOffset i Range.endOffset broje UTF-16 kodne jedinice u CharacterData, a u elementima broje podređene čvorove, ne znakove. Range.commonAncestorContainer vraća najdublji zajednički čvor koji sadrži obje granice; to može biti sam tekstni čvor. Range.collapsed znači da su granice jednake, a ne samo da je tekst prazan.

Range.extractContents() uklanja sadržaj i vraća DocumentFragment: potpuno obuhvaćene čvorove premješta, dok djelomično obuhvaćene strukture kopira prema potrebi. Range.deleteContents() uklanja sadržaj bez vraćanja fragmenta. Obje operacije sažimaju raspon. Range.insertNode(node) umeće na početku umjesto da zamijeni sadržaj; može razdvojiti tekstni čvor i proširiti sažeti raspon.

Range.setStartAfter(node) postavlja početak iza čvora u njegovu roditelju; čvor mora imati roditelja. Range.collapse(true) sažima raspon na početak, dok ga Range.collapse(false) ili Range.collapse() sažima na kraj. Range.cloneRange() stvara zaseban živi raspon s istim granicama, a ne kopiju DOM-a ni nepromjenjivu snimku: kasnije promjene mogu utjecati na oba raspona.

Primjeri

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

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori