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 thestartContainer theRange 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()

Вставляет aNode в начало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 theRange; this would be the union of all the rectangles returned byrange.getClientRects().

Range.getClientRects()Экспериментальная возможность

Returns a list ofClientRect objects that aggregates the results ofElement.getClientRects() for all the elements in theRange.

Range.intersectsNode()Экспериментальная возможность

Возвращаетboolean указывающий, пересекает ли данный узелRange.

Range.isPointInRange()Экспериментальная возможность

Returns aboolean indicating whether the given point is in theRange.

Спецификации

Совместимость с браузерами

Смотрите также

• The DOM interfaces index