CKTIS / JavaScript
Редактиране на DOM с Range
Изрязвайте, вмъквайте и изтривайте съдържание в DOM. Научете как да задавате границите на диапазона, да го свивате до точка и какво копира `cloneRange()`.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
range.extractContents() → DocumentFragment
range.insertNode(newNode) → undefined
range.deleteContents() → undefined
range.setStartAfter(referenceNode) → undefined
range.collapse() → undefined
range.collapse(toStart) → undefined
range.cloneRange() → RangeRange е жив диапазон в DOM с начална и крайна граница. Всяка граница се задава с възел контейнер и отместване. В текстов възел отместването брои кодови единици UTF-16, а в елемент — предхождащите границата дъщерни възли, не само дъщерните елементи. Range е част от DOM, а не от ECMAScript 2024; средата за изпълнение трябва да предоставя DOM.
extractContents() премахва съдържанието на диапазона и връща DocumentFragment. Методът премества изцяло обхванатите възли, копира избраните части от текста и при нужда клонира частично обхванатите елементи, за да запази структурата. deleteContents() премахва съдържанието, без да връща фрагмент (undefined). И двата метода свиват диапазона до една точка. Ако вече е свит, извличането връща празен фрагмент, а изтриването не прави нищо.
insertNode(newNode) вмъква в началната граница, без да заменя съдържанието на диапазона. Ако границата е в текстов възел, методът го разделя в тази точка. При DocumentFragment премества дъщерните му възли и оставя фрагмента празен. Вмъкването може да разшири диапазон, свит до точка. Невалидна йерархия може да предизвика HierarchyRequestError. Вмъкването не обезопасява съдържанието: поставяйте недоверен обикновен текст в текстов възел, вместо да го обработвате като HTML.
setStartAfter(referenceNode) поставя началото непосредствено след референтния възел, в неговия родителски възел. Ако възелът няма родител, възниква InvalidNodeTypeError. Ако новото начало е след края или в друго дърво, краят също се премества там. collapse(true) свива диапазона до началото, а collapse(false) и collapse() — до края. Тези два метода и insertNode() връщат undefined.
cloneRange() връща отделен Range с първоначално еднакви граници, без да копира възли. Задаването на граница на единия диапазон не премества пряко другия, но и двата остават живи: промените в DOM могат да коригират границите и на двата. Клонингът не е моментна снимка на съдържанието.
Примери
<!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>Резултат
before: B / true moved: AC / XBY / 0 final: XB / true
Запазете примера като HTML файл, отворете го в браузър и проверете резултата в конзолата за разработчици. Свиването на копието до точка оставя `B` в първоначалния диапазон. Извлеченият възел се вмъква между `X` и `Y`, фрагментът остава празен и накрая `Y` се изтрива.
Свързани уроци
- JavaScript · Урок 33 · Средно · Версия: 3
Източници
- 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