База знанияИзпитен център
BGБългарски
Избери език13

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() → Range

Range е жив диапазон в 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

Източници