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

CKTIS / JavaScript

Selection: броене на диапазони с rangeCount и добавяне с addRange()

`rangeCount` показва колко диапазона съдържа селекцията в документа, а `addRange()` добавя диапазон от DOM. За да замените селекцията с един диапазон в различни браузъри, първо я изчистете.

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

Синтаксис

// Web platform: Selection API (not part of ECMAScript).
const selection = window.getSelection(); // Selection | null
if (selection !== null) {
  const count = selection.rangeCount;    // read-only number
  selection.addRange(range);            // takes a Range; returns undefined
}

Selection представя селекцията в документа или позицията на текстовия курсор. Вземете обекта с window.getSelection() и проверете дали резултатът е null. Това е API на уеб платформата, а не част от ECMAScript 2024. За текст в textarea или в поддържан тип input използвайте метода на елемента setSelectionRange().

rangeCount е числово свойство само за четене. То брои обектите Range, а не знаците. 0 означава, че няма диапазон. Дори без маркиран текст може да е изпълнено rangeCount === 1: диапазон, свит до една точка, също се брои. Преди да извикате getRangeAt(0), проверете дали rangeCount > 0, защото индекс извън допустимите граници предизвиква изключение.

addRange(range) приема един обект Range и връща undefined, така че върнатата стойност не показва дали диапазонът е добавен. Създайте диапазон с document.createRange() и задайте границите му, например чрез range.selectNodeContents(node) за възел, включен в същия документ. Range е динамичен обект: промените в DOM могат да изместят границите му.

Спецификацията допуска най-много един диапазон на селекция, но Firefox поддържа няколко. Браузър, ограничен до един диапазон, може да пренебрегне следващо извикване на addRange(), вместо да замени съществуващия диапазон. За да зададете надеждно един нов диапазон, първо извикайте removeAllRanges(). Това изчиства предишната селекция, а не съдържанието на документа.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Selection API example</title>
</head>
<body>
  <script>
    (() => {
      const selection = window.getSelection();
      if (selection === null) throw new Error("No document selection available");

      const paragraph = document.createElement("p");
      paragraph.textContent = "CKTIS";
      document.body.append(paragraph);

      try {
        const range = document.createRange();
        range.selectNodeContents(paragraph);

        selection.removeAllRanges();
        console.log(selection.rangeCount);
        selection.addRange(range);
        console.log(selection.rangeCount);
        console.log(selection.toString());
      } finally {
        selection.removeAllRanges();
        paragraph.remove();
      }
    })();
  </script>
</body>
</html>

Резултат

0
1
CKTIS

Запазете примера като файл `.html`, отворете го в отделен раздел на браузъра и проверете конзолата за разработчици. След изчистването на селекцията се извежда `0`, а след добавянето на диапазона — `1` и `CKTIS`. Накрая кодът изчиства селекцията и премахва временния абзац, без да възстановява предишната селекция.

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

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

Източници