Range
Range(диапазон)
интерфейс предоставляет фрагмент документа который может содержать узлы и части текстовых узлов данного документа.
Range может быть создан с помощью метода createRange
, у объекта Document
. Или объект Range можно получить с помощью метода getRangeAt
, у объекта Selection
. А также с помощью конструктора Range()
.
Свойства
Нет унаследованных свойств.
Range.collapsed
Только для чтения
Возвращает Boolean
указывающий, находятся ли начало и конец диапазона
на одной и той же позиции.
Range.startContainer
Только для чтения-
Возвращает
Node
внутри которогоRange
начинается. Range.endContainer
Только для чтения-
Возвращает
Node
внутри которогоRange
заканчивается . Range.commonAncestorContainer
Только для чтения-
Возвращает самый глубокий
Node
который содержит узлыstartContainer
иendContainer
. Range.endOffset
Только для чтения-
Возвращает число равное расположению
endContainer
вRange
. Range.startOffset
Только для чтения-
Returns a number representing where in the
startContainer
theRange
starts.
Конструктор
Методы
Не имеют унаследованных свойств.
Range.setStart()
-
Назначают начальную позицию
Range
. Range.setEnd()
-
Назначает конечную позицию
Range
. Range.setStartBefore()
-
Устанавливает начальную позицию
Range
относительно другогоNode
пред ним. Range.setStartAfter()
-
Устанавливает начальную позицию
Range
относительно другогоNode
после него. Range.setEndBefore()
-
Устанавливает конечную позицию
Range
относительно другогоNode
перед ним. Range.setEndAfter()
-
Устанавливает конечную позицию
Range
относительно другогоNode
после него. Range.selectNode()
-
Выбирает
Range
to содержащийNode
и его контент. Range.selectNodeContents()
-
Выбирает
Range
содержащий контентNode
. Range.collapse()
-
Схлопывает
Range
до одной из граничных точек. Range.cloneContents()
-
Возвращает
DocumentFragment
содержащийся в узлеRange
. Range.deleteContents()
-
Удаляет содержимое
Range
изDocument
. Range.extractContents()
-
Переносит содержимое
Range
из дерева документа вDocumentFragment
. Range.insertNode()
-
Вставляет a
Node
в началоRange
. Range.surroundContents()
-
Переносит содержимое
Range
в новыйNode
. Range.compareBoundaryPoints()
-
Сравнивает граничные точки
Range
с другимRange
. Range.cloneRange()
-
Возвращает объект из
Range
с граничными точками идентичными клонированномуRange
. Range.detach()
-
Освобождает Range
от использования для улучшения производительности . Range.toString()
-
Возвращает текст в
Range
. Range.compareNode()
Non-standard-
Возвращает константу, представляющую, находится ли
Node
до, после, внутри или вокруг range. Range.comparePoint()
Экспериментальная возможность-
Возвращает -1, 0, или 1 в зависимости от того, находиться ли referenceNode перед, внутри, или после
Range
. Range.createContextualFragment()
Экспериментальная возможность-
Возвращает
DocumentFragment
созданный из полученной строки с кодом. Range.getBoundingClientRect()
Экспериментальная возможность-
Возвращает объект
ClientRect
object which bounds the entire contents of theRange
; this would be the union of all the rectangles returned byrange.getClientRects()
. Range.getClientRects()
Экспериментальная возможность-
Returns a list of
ClientRect
objects that aggregates the results ofElement.getClientRects()
for all the elements in theRange
. Range.intersectsNode()
Экспериментальная возможность-
Возвращает
boolean
указывающий, пересекает ли данный узелRange
. Range.isPointInRange()
Экспериментальная возможность-
Returns a
boolean
indicating whether the given point is in theRange
.
Спецификации
Specification |
---|
DOM Standard # interface-range |
DOM Parsing and Serialization # extensions-to-the-range-interface |
CSSOM View Module # extensions-to-the-range-interface |
Совместимость с браузерами
BCD tables only load in the browser