JavaScript Selection.getRangeAt() — діапазон виділення

Метод getRangeAt() повертає діапазон виділення за його номером. Майже завжди потрібен нульовий.

правити

Загальний опис

Виділення теоретично може складатись із кількох діапазонів (у Firefox їх можна зробити з Ctrl), але на практиці працюють із першим.

І головне: якщо виділення порожнє, діапазонів немає взагалі, і виклик кине помилку. Тому перед ним завжди перевіряють rangeCount або isCollapsed.

правити

Нотатка

getRangeAt(0) на порожньому виділенні кидає IndexSizeError. Перевірка rangeCount > 0 обов'язкова.

автор: NagarD правити

+ додати пораду чи нотатку

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
getRangeAt	1+	1+	1+	7+	12+	9+

Підтримка: мобільні переглядачі

Переглядач
getRangeAt	yes	yes	yes	yes

Приклади

+ запропонувати свій приклад у пісочниці

(function () {
    const selection = window.getSelection();

    // без цієї перевірки — IndexSizeError
    if (selection.rangeCount === 0) {
        return;
    }

    const range = selection.getRangeAt(0);

    console.log(range.toString());
    console.log(range.getBoundingClientRect());
})();