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

CKTIS / JavaScript

Urejanje DOM-a z Range

Izrežite, vstavite in izbrišite vsebino DOM-a. Naučite se določiti meji obsega, ga skrčiti na eno točko in prepoznati, kaj kopira `cloneRange()`.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

range.extractContents() → DocumentFragment
range.insertNode(newNode) → undefined
range.deleteContents() → undefined
range.setStartAfter(referenceNode) → undefined
range.collapse() → undefined
range.collapse(toStart) → undefined
range.cloneRange() → Range

Range je živ obseg v DOM-u z začetno in končno mejo. Vsaka meja je par vozlišča in odmika v njem. V besedilnem vozlišču odmik šteje kodne enote UTF-16, v elementu pa predhodna otroška vozlišča, ne samo otroških elementov. Range je del DOM-a, ne ECMAScripta 2024; izvajalno okolje mora zagotavljati DOM.

extractContents() odstrani vsebino obsega in vrne DocumentFragment. Popolnoma zajeta vozlišča premakne, izbrane dele besedila kopira, delno zajete elemente pa po potrebi klonira, da ohrani strukturo. deleteContents() odstrani vsebino brez vračanja fragmenta (undefined). Obe metodi skrčita obseg na eno točko. Če je že skrčen, izrez vrne prazen fragment, brisanje pa ne naredi ničesar.

insertNode(newNode) vstavi vozlišče na začetni meji, ne da bi nadomestil vsebino obsega. Če je meja v besedilnem vozlišču, ga na tem mestu razdeli. Pri DocumentFragment premakne njegova otroška vozlišča in fragment ostane prazen. Vstavljanje lahko razširi obseg, skrčen na točko. Neveljavna hierarhija lahko povzroči HierarchyRequestError. Vstavljanje vsebine ne očisti; nezaupanja vredno navadno besedilo vstavite v besedilno vozlišče, namesto da ga razčlenite kot HTML.

setStartAfter(referenceNode) postavi začetek takoj za referenčno vozlišče, v njegovega starša. Če vozlišče nima starša, pride do InvalidNodeTypeError. Če je novi začetek za koncem ali v drugem drevesu, se na to točko premakne tudi konec. collapse(true) skrči obseg na začetek, collapse(false) in collapse() pa na konec. Ti dve metodi in insertNode() vrnejo undefined.

cloneRange() vrne ločen Range s sprva enakima mejama, ne da bi kopiral vozlišča. Nastavitev meje enega obsega ne premakne neposredno drugega, vendar oba ostaneta živa: spremembe DOM-a lahko prilagodijo meje obeh. Klon ni posnetek vsebine.

Primeri

<!doctype html>
<meta charset="utf-8">
<title>Editing the DOM with Range</title>
<script>
(() => {
  const source = document.createElement('p');
  const target = document.createElement('p');
  const item = document.createElement('em');
  item.textContent = 'B';
  source.append('A', item, 'C');
  target.textContent = 'XY';

  const cut = document.createRange();
  cut.selectNode(item);
  const copy = cut.cloneRange();
  copy.collapse(true);
  console.log(`before: ${cut.toString()} / ${copy.collapsed}`);

  const fragment = cut.extractContents();
  const edit = document.createRange();
  edit.setStart(target.firstChild, 1);
  edit.collapse(true);
  edit.insertNode(fragment);
  console.log(`moved: ${source.textContent} / ${target.textContent} / ${fragment.childNodes.length}`);

  edit.setStartAfter(item);
  edit.collapse(true);
  edit.setEnd(target, target.childNodes.length);
  edit.deleteContents();
  console.log(`final: ${target.textContent} / ${edit.collapsed}`);
})();
</script>

Rezultat

before: B / true
moved: AC / XBY / 0
final: XB / true

Primer shranite kot datoteko HTML, odprite jo v brskalniku in preverite izpis v razvijalski konzoli. Ko kopijo skrčite na točko, `B` ostane v prvotnem obsegu. Izrezano vozlišče se vstavi med `X` in `Y`, fragment se izprazni, nato pa se izbriše `Y`.

Povezane lekcije

  • JavaScript · Lekcija 33 · Srednja · Različica: 3

Viri