Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Range — živi razpon v drevesu DOM

Range opisuje del DOM med dvema mejama. Omogoča izrezovanje, odstranjevanje in vstavljanje vsebine, njegove meje pa se samodejno odzivajo na spremembe drevesa.

Različica: 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 razpon, določen z dvema paroma vozlišče in odmik. Ustvarite ga z document.createRange() ali new Range(). Gre za spletni API standarda DOM, ne za funkcijo določene izdaje ECMAScripta; prisotnost Node 24 v repozitoriju ne dokazuje, da je API na voljo. Primer zahteva DOM v brskalniku.

Range.startOffset in Range.endOffset v CharacterData štejeta 16-bitne kodne enote UTF-16, v elementih pa podrejena vozlišča, ne znakov. Range.commonAncestorContainer vrne najgloblje skupno vozlišče, ki vsebuje obe meji; to je lahko samo besedilno vozlišče. Range.collapsed pomeni, da sta meji enaki, ne zgolj, da je besedilo prazno.

Range.extractContents() odstrani vsebino in vrne DocumentFragment: v celoti zajeta vozlišča premakne, delno zajete strukture pa po potrebi kopira. Range.deleteContents() odstrani vsebino, ne da bi vrnil fragment. Obe operaciji strneta razpon. Range.insertNode(node) vstavi na začetek, namesto da bi zamenjal vsebino; lahko razdeli besedilno vozlišče in razširi strnjeni razpon.

Range.setStartAfter(node) nastavi začetek za vozliščem v njegovem nadrejenem vozlišču; vozlišče mora imeti nadrejeno vozlišče. Range.collapse(true) strne razpon na začetek, Range.collapse(false) ali Range.collapse() pa na konec. Range.cloneRange() ustvari ločen živi razpon z enakima mejama, ne kopije DOM ali nespremenljivega posnetka: poznejše spremembe lahko vplivajo na oba razpona.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri