Range

Этот перевод не завершен. Пожалуйста, помогите перевести эту статью с английского

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

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

Свойства

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

Range.collapsed Только для чтения
Возвращает Boolean указывающий, находятся ли range's start and
на одной и той же позиции.

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 the Range starts.

Конструктор

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

Методы

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

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(): Возвращает константу, представляющую, находится ли Node до, после, внутри или вокруг range.
Range.comparePoint(): Возвращает -1, 0, или 1 в зависимости от того, находиться ли referenceNode перед, внутри, или после Range.
Range.createContextualFragment(): Возвращает 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().
Range.getClientRects(): Returns a list of ClientRect objects that aggregates the results of Element.getClientRects() for all the elements in the Range.
Range.intersectsNode(): Возвращает boolean указывающий, пересекает ли данный узел Range.
Range.isPointInRange(): 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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Настольные
Мобильные

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	(Да)	1.0 (1.7 или ранее) [1]	9.0	9.0	(Да)
`Range()` constructor	(Да)	24.0 (24.0)	Нет	15.0	(Да)
`compareNode()`	Нет	1.0 (1.7 или ранее) Removed in 3.0 (1.9)	Нет	Нет	Нет
`isPointInRange()`, and `comparePoint()`	(Да)	(Да)	Нет	15.0	?
`intersectsNode()`	(Да)	17.0 (17.0) [2]	Нет	15.0	?
`getClientRects()` and `getBoundingClientRect()`	(Да)	4.0 (2.0)	9	15.0	5
`createContextualFragment()`	(Да)	(Да)	Нет	15.0	?

Feature	Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	(Да)	1.0 (1.0) [1]	9.0	9.0	(Да)

[1] Starting with Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10) the Range object throws a DOMException as defined in DOM 4, instead of a RangeException defined in prior specifications.

[2] Gecko supported it up to Gecko 1.9, then removed it until Gecko 17 where it was reimplemented, matching the spec.