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
theRange
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 theRange
; this would be the union of all the rectangles returned byrange.getClientRects()
(en-US). Range.getClientRects()
(en-US) Экспериментальная возможность-
Returns a list of
ClientRect
objects that aggregates the results ofElement.getClientRects()
(en-US) for all the elements in theRange
. Range.intersectsNode()
(en-US) Экспериментальная возможность-
Возвращает
boolean
указывающий, пересекает ли данный узелRange
. Range.isPointInRange()
(en-US) Экспериментальная возможность-
Returns a
boolean
indicating whether the given point is in theRange
.
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