Selection.getRangeAt()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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

Синтаксис

range = sel.getRangeAt(index)

Параметры

range

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

index

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

Примеры

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, интерфейс, к которому принадлежит метод.
  • Tree Selection (для метода getRangeAt() в интерфейсе nsITreeSelection)