Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Úprava DOM pomocou Range

Vyberajte, vkladajte a odstraňujte obsah DOM. Naučte sa nastaviť hranice rozsahu, zúžiť ho na jeden bod a rozlíšiť, čo kopíruje `cloneRange()`.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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ý rozsah v DOM so začiatočnou a koncovou hranicou. Každú hranicu tvorí uzol a posun v ňom. V textovom uzle posun počíta kódové jednotky UTF-16, v elemente predchádzajúce dcérske uzly, nielen dcérske elementy. Range patrí do DOM, nie do ECMAScriptu 2024; behové prostredie musí poskytovať DOM.

extractContents() vyberie obsah rozsahu a vráti DocumentFragment. Úplne zahrnuté uzly presunie, vybrané časti textu skopíruje a v prípade potreby naklonuje čiastočne zahrnuté elementy, aby zachoval štruktúru. deleteContents() odstráni obsah bez vrátenia fragmentu (undefined). Obe metódy zúžia rozsah na jediný bod. Ak je už zúžený, extrakcia vráti prázdny fragment a odstránenie nič neurobí.

insertNode(newNode) vkladá na začiatočnú hranicu bez nahradenia obsahu rozsahu. Ak je hranica v textovom uzle, rozdelí ho v danom bode. Pri DocumentFragment presunie jeho dcérske uzly a fragment zostane prázdny. Vloženie môže rozsah zúžený na bod rozšíriť. Neplatná hierarchia môže vyvolať HierarchyRequestError. Vkladanie obsah neočisťuje; nedôveryhodný obyčajný text vložte do textového uzla, namiesto toho, aby ste ho spracovali ako HTML.

setStartAfter(referenceNode) nastaví začiatok tesne za referenčný uzol v jeho rodičovi. Uzol bez rodiča vyvolá InvalidNodeTypeError. Ak je nový začiatok za koncom alebo v inom strome, presunie sa tam aj koniec. collapse(true) zúži rozsah na začiatok, collapse(false) a collapse() na koniec. Tieto dve metódy a insertNode() vracajú undefined.

cloneRange() vráti samostatný Range so spočiatku rovnakými hranicami bez kopírovania uzlov. Nastavenie hranice jedného rozsahu priamo nepresunie druhý, no oba zostávajú živé: zmeny DOM môžu upraviť hranice oboch. Klon nie je snímkou obsahu.

Príklady

<!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>

Výsledok

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

Uložte príklad ako súbor HTML, otvorte ho v prehliadači a pozrite si výstup v konzole pre vývojárov. Zúženie kópie na bod ponechá `B` v pôvodnom rozsahu. Vybratý uzol sa vloží medzi `X` a `Y`, fragment sa vyprázdni a nakoniec sa odstráni `Y`.

Súvisiace lekcie

  • JavaScript · Lekcia 33 · Stredne pokročilá · Verzia: 3

Zdroje