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) Non-standard

Возвращает константу, представляющую, находится ли 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