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.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/ru/web/api/selection/index.md)

Метод 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)