В процессе перевода.

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.

See also

Метки документа и участники

Метки: 
Внесли вклад в эту страницу: Horhik, mdnwebdocs-bot, fakedous, fscholz
Обновлялась последний раз: Horhik,