Selection.getRangeAt()

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Метод Selection.getRangeAt() возвращает объект диапазона, который представляет один из диапазонов, выделенного на данный момент.

Синтаксис

range = sel.getRangeAt(index)

Параметры

range

Объект Range, который будет возвращён.

index

Индекс диапазона, начинающийся с нуля, который необходимо вернуть. Отрицательное значение или значение выше или равное Selection.rangeCount (en-US) приведёт к ошибке.

Примеры

js
var ranges = [];

sel = window.getSelection();

for (var i = 0; i < sel.rangeCount; i++) {
  ranges[i] = sel.getRangeAt(i);
}
/* Каждый элемент в массиве диапазонов является
 * объектом диапазона, который представляет
 * один из диапазонов текущего выделения */

Спецификации

Specification
Selection API
# dom-selection-getrangeat

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также

  • Selection (en-US), интерфейс, к которому принадлежит метод.
  • Tree Selection (для метода getRangeAt() в интерфейсе nsITreeSelection)