Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Selection: liczenie i dodawanie zakresów za pomocą rangeCount i addRange()

`rangeCount` podaje liczbę zakresów w zaznaczeniu dokumentu, a `addRange()` dodaje zakres DOM. Aby niezależnie od przeglądarki zastąpić zaznaczenie jednym zakresem, najpierw je wyczyść.

Wersja: Current web platform; runtime support varies

Składnia

// 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 reprezentuje zaznaczenie dokumentu albo pozycję kursora tekstowego. Pobierz ten obiekt przez window.getSelection() i sprawdź, czy wynik nie jest równy null. To API platformy webowej, a nie część ECMAScript 2024. Do zaznaczania tekstu w textarea lub obsługiwanym typie input użyj metody elementu setSelectionRange().

rangeCount to właściwość liczbowa tylko do odczytu. Liczy zakresy Range, nie znaki. 0 oznacza brak zakresu. Zaznaczenie może mieć rangeCount === 1, nawet gdy żaden tekst nie jest podświetlony: zakres zwinięty do jednego punktu nadal się liczy. Przed wywołaniem getRangeAt(0) sprawdź, czy rangeCount > 0, ponieważ indeks poza zakresem powoduje wyjątek.

addRange(range) przyjmuje jeden obiekt Range i zwraca undefined, więc wynik wywołania nie informuje o powodzeniu. Utwórz zakres przez document.createRange() i ustaw jego granice, na przykład przez range.selectNodeContents(node) dla węzła dołączonego do tego samego dokumentu. Range jest obiektem żywym: zmiany w DOM mogą przesunąć jego granice.

Specyfikacja przewiduje co najwyżej jeden zakres na zaznaczenie, ale Firefox obsługuje wiele zakresów. Przeglądarka ograniczona do jednego zakresu może zignorować kolejne wywołanie addRange(), zamiast zastąpić istniejący zakres. Aby przewidywalnie ustawić jeden nowy zakres, wywołaj najpierw removeAllRanges(). To usuwa dotychczasowe zaznaczenie, nie treść dokumentu.

Przykłady

<!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>

Wynik

0
1
CKTIS

Zapisz przykład jako plik `.html`, otwórz go w osobnej karcie przeglądarki i sprawdź konsolę deweloperską. Kod wypisuje `0` po wyczyszczeniu zaznaczenia, a po dodaniu zakresu `1` i `CKTIS`. Na końcu usuwa zaznaczenie i tymczasowy akapit; nie przywraca poprzedniego zaznaczenia.

Powiązane lekcje

  • JavaScript · Lekcja 33 · Średniozaawansowany · Wersja: 3

Źródła