Range

Range(диапазон) интерфейс предоставляет фрагмент документа который может содержать узлы и части текстовых узлов  данного документа. 

Range может быть создан с помощью метода createRange, у объекта Document. Или объект Range можно получить с помощью метода getRangeAt, у объекта Selection. А также с помощью конструктора Range() (en-US).

Свойства

Нет унаследованных свойств.

Range.collapsed Только для чтения
Возвращает Boolean (en-US) указывающий, находятся ли начало и конец диапазона
на одной и той же позиции.

Range.startContainer (en-US) Только для чтения
Возвращает Node внутри которого Range начинается.
Range.endContainer (en-US) Только для чтения
Возвращает Node внутри которого Range заканчивается .
Range.commonAncestorContainer (en-US) Только для чтения
Возвращает самый глубокий Node который содержит узлы startContainer и endContainer.
Range.endOffset (en-US) Только для чтения
Возвращает число равное расположению endContainer в Range .
Range.startOffset (en-US) Только для чтения
Returns a number representing where in the startContainer the Range starts.

Конструктор

Range() (en-US)
Возвращают объект Range с глобальным  Document как начало и конец.

Методы

Не имеют унаследованных свойств.

Range.setStart() (en-US)
Назначают начальную позицию Range.
Range.setEnd() (en-US)
Назначает конечную позицию Range.
Range.setStartBefore() (en-US)
Устанавливает начальную позицию Range относительно другого Node пред ним.
Range.setStartAfter() (en-US)
Устанавливает начальную позицию Range относительно другого Node после него.
Range.setEndBefore() (en-US)
Устанавливает конечную позицию Range относительно другого Node перед ним.
Range.setEndAfter() (en-US)
Устанавливает конечную позицию Range относительно другого Node после него.
Range.selectNode() (en-US)
Выбирает Range to содержащий Node и его контент.
Range.selectNodeContents() (en-US)
Выбирает Range содержащий контент Node.
Range.collapse() (en-US)
Схлопывает Range до одной из граничных точек.
Range.cloneContents() (en-US)
Возвращает DocumentFragment содержащийся в узле Range.
Range.deleteContents() (en-US)
Удаляет содержимое Range изDocument.
Range.extractContents() (en-US)
Переносит содержимое Range из дерева документа в DocumentFragment.
Range.insertNode() (en-US)
Вставляет a Node в начало Range.
Range.surroundContents()
Переносит содержимое Range в новый Node.
Range.compareBoundaryPoints() (en-US)
Сравнивает граничные точки Range с другим Range.
Range.cloneRange() (en-US)
Возвращает  объект из Range с граничными точками идентичными клонированному Range.
Range.detach() (en-US)
Освобождает Range от использования для улучшения производительности .
Range.toString() (en-US)
Возвращает текст в Range.
Range.compareNode() (en-US) Этот API вышел из употребления и его работа больше не гарантируется.
Возвращает константу, представляющую, находится ли Node до, после, внутри или вокруг  range.
Range.comparePoint() (en-US)
Возвращает -1, 0, или 1 в зависимости от того, находиться ли referenceNode перед, внутри, или после  Range.
Range.createContextualFragment() (en-US)
Возвращает DocumentFragment созданный из полученной строки с кодом.
Range.getBoundingClientRect()
Возвращает объект ClientRect object which bounds the entire contents of the Range; this would be the union of all the rectangles returned by range.getClientRects() (en-US).
Range.getClientRects() (en-US)
Returns a list of ClientRect objects that aggregates the results of Element.getClientRects() (en-US) for all the elements in the Range.
Range.intersectsNode() (en-US)
Возвращает boolean указывающий, пересекает ли данный узел Range.
Range.isPointInRange() (en-US)
Returns a boolean indicating whether the given point is in the Range.

Specifications

Specification Status Comment
DOM
Определение 'Range' в этой спецификации.
Живой стандарт Do not use RangeException anymore, use DOMException instead.
Made the second parameter of collapse() optional.
Added the methods isPointInRange(), comparePoint(), and intersectsNode().
Added the constructor Range().
DOM Parsing and Serialization
Определение 'Extensions to Range' в этой спецификации.
Рабочий черновик Added the method createContextualFragment().
CSS Object Model (CSSOM) View Module
Определение 'Extensions to Range' в этой спецификации.
Рабочий черновик Added the methods getClientRects() and getBoundingClientRect().
Document Object Model (DOM) Level 2 Traversal and Range Specification
Определение 'Range' в этой спецификации.
Устаревшая Initial specification.

Browser compatibility

BCD tables only load in the browser

See also