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

CKTIS / JavaScript

Range: общ контейнер, отмествания и свит диапазон

Прочети границите на диапазон в DOM, намери най-близкия им общ възел и провери дали и двете граници сочат една и съща точка.

Версия: Current web platform; runtime support varies

Синтаксис

range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsed

Range е интерфейс на DOM, а не част от ECMAScript 2024. Наличността на тези свойства зависи от реализацията на DOM в средата за изпълнение, а не от изданието на ECMAScript. Не приемай, че са налични в среда без DOM. Всяка граница е двойка от възел и отместване. Чети startOffset заедно със startContainer, а endOffset — с endContainer.

Отместването е позиция, броена от нула, а не индексът на последния включен знак. Във възел CharacterData, например Text, то брои кодовите единици на UTF-16 преди границата, а не знаците, които потребителят възприема. В контейнер като Element то брои преките дъщерни възли преди границата, включително текст и коментари, както в childNodes. 0 е преди първата единица или първия дъщерен възел; пълната дължина означава позиция след последния.

commonAncestorContainer връща най-дълбоко вложения възел, който за всеки граничен контейнер е или самият контейнер, или негов предшественик. Ако двата контейнера са един и същ възел, се връща той, дори да е Text. collapsed е true само когато двете граници имат един и същ възел и едно и също отместване. Еднакви отмествания в различни възли не са достатъчни.

И четирите свойства на екземпляра са само за четене; startOffset, endOffset и collapsed се наследяват от AbstractRange. Мести границите със setStart() и setEnd(). collapse(true) свива диапазона до началото, а collapse(false) или collapse() — до края. Range е динамичен: промените в DOM могат да коригират границите му.

Примери

<!doctype html>
<meta charset="utf-8">
<title>DOM Range boundary points</title>
<script>
{
  const container = document.createElement('div');
  const text = document.createTextNode('A😀B');
  container.appendChild(text);

  const range = document.createRange();
  range.setStart(text, 3);
  range.setEnd(container, 1);

  const logRange = (expectedAncestor) => {
    console.log(JSON.stringify([
      range.commonAncestorContainer === expectedAncestor,
      range.startOffset,
      range.endOffset,
      range.collapsed,
      range.toString(),
    ]));
  };

  logRange(container);
  range.collapse(true);
  logRange(text);
}
</script>

Резултат

[true,3,1,false,"B"]
[true,3,3,true,""]

Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата. Отместване `3` в текстовия възел е точно след емоджито, което заема две кодови единици на UTF-16. Отместване `1` в елемента е след единствения му дъщерен възел. Затова диапазонът съдържа `B`. След `collapse(true)` и двете граници са на отместване `3` в текстовия възел, който вече е общият контейнер.

Свързани уроци

  • JavaScript · Урок 33 · Средно · Версия: 3

Източници