CKTIS / JavaScript
Uređivanje DOM-a pomoću Range
Izrežite, umetnite i izbrišite sadržaj DOM-a. Naučite postaviti granice raspona, svesti ga na jednu točku i razlikovati što kopira `cloneRange()`.
Verzija: 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() → RangeRange je živi raspon u DOM-u s početnom i završnom granicom. Svaku granicu čine čvor spremnik i pomak u njemu. U tekstnom čvoru pomak označava broj kodnih jedinica UTF-16 prije granice. U elementu označava broj čvorova koji su njegova izravna djeca i prethode granici, uključujući i čvorove koji nisu elementi. Range pripada DOM-u, a ne ECMAScriptu 2024; izvršno okruženje mora pružati DOM.
extractContents() uklanja sadržaj raspona i vraća DocumentFragment. Premješta potpuno obuhvaćene čvorove, kopira odabrane dijelove teksta i po potrebi klonira djelomično obuhvaćene elemente kako bi očuvao strukturu. deleteContents() uklanja sadržaj bez vraćanja fragmenta (undefined). Obje metode svode raspon na jednu točku. Ako je raspon već sveden na točku, izdvajanje vraća prazan fragment, a brisanje ne radi ništa.
insertNode(newNode) umeće na početnoj granici bez zamjene sadržaja raspona. Ako je granica u tekstnom čvoru, dijeli taj čvor na tom mjestu. Ako se proslijedi DocumentFragment, premješta njegovu djecu i ostavlja fragment prazan. Umetanje može proširiti raspon sveden na točku. Nevaljana hijerarhija može izazvati HierarchyRequestError. Umetanje ne pročišćava sadržaj: nepouzdan običan tekst stavite u tekstni čvor umjesto da ga parsirate kao HTML.
setStartAfter(referenceNode) postavlja početak odmah iza referentnog čvora, u njegovu roditelju. Čvor bez roditelja izaziva InvalidNodeTypeError. Ako je novi početak iza kraja ili u drugom stablu, i kraj se premješta na tu točku. collapse(true) svodi raspon na početak, a collapse(false) i collapse() na kraj. Te dvije metode i insertNode() vraćaju undefined.
cloneRange() vraća zaseban Range s isprva jednakim granicama, bez kopiranja čvorova. Postavljanje granice jednog raspona ne premješta izravno drugi, ali oba ostaju živa: promjene DOM-a mogu prilagoditi granice obaju raspona. Klon nije snimka sadržaja.
Primjeri
<!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
Spremite primjer kao HTML datoteku, otvorite je u pregledniku i provjerite ispis u razvojnoj konzoli. Svođenje kopije na točku ostavlja `B` u izvornom rasponu. Izdvojeni se čvor umeće između `X` i `Y`, fragment se prazni, a zatim se briše `Y`.
Povezane lekcije
- JavaScript · Lekcija 33 · Srednje · Verzija: 3
Izvori
- Range - Web APIs | MDN
- Range: extractContents() method - Web APIs | MDN
- Range: insertNode() method - Web APIs | MDN
- Range: deleteContents() method - Web APIs | MDN
- Range: setStartAfter() method - Web APIs | MDN
- Range: collapse() method - Web APIs | MDN
- Range: cloneRange() method - Web APIs | MDN
- Range: setStart() method - Web APIs | MDN
- StaticRange - Web APIs | MDN
- DOMException - Web APIs | MDN
- Element: innerHTML property - Web APIs | MDN