From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/range/index.html | 243 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 243 insertions(+) create mode 100644 files/ru/web/api/range/index.html (limited to 'files/ru/web/api/range/index.html') diff --git a/files/ru/web/api/range/index.html b/files/ru/web/api/range/index.html new file mode 100644 index 0000000000..b46091e373 --- /dev/null +++ b/files/ru/web/api/range/index.html @@ -0,0 +1,243 @@ +--- +title: Range +slug: Web/API/Range +tags: + - API + - DOM +translation_of: Web/API/Range +--- +

{{ APIRef("DOM") }}

+ +

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

+ +

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

+ +

Свойства

+ +

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

+ +

{{domxref("Range.collapsed")}} {{readonlyInline}}
+ Возвращает {{domxref("Boolean")}} указывающий, находятся ли начало и конец диапазона
+ на одной и той же позиции.

+ +
+
{{domxref("Range.startContainer")}} {{readonlyInline}}
+
Возвращает {{ domxref("Node") }} внутри которого Range начинается.
+
{{domxref("Range.endContainer")}} {{readonlyInline}}
+
Возвращает {{ domxref("Node") }} внутри которого Range заканчивается .
+
{{domxref("Range.commonAncestorContainer")}} {{readonlyInline}}
+
Возвращает самый глубокий {{ domxref("Node") }} который содержит узлы startContainer и endContainer.
+
{{domxref("Range.endOffset")}} {{readonlyInline}}
+
Возвращает число равное расположению endContainer в Range .
+
+
{{domxref("Range.startOffset")}} {{readonlyInline}}
+
Returns a number representing where in the startContainer the Range starts.
+
+ +

Конструктор

+ +
+
{{ domxref("Range.Range()", "Range()") }} {{experimental_inline}}
+
Возвращают объект Range с глобальным  {{domxref("Document")}} как начало и конец.
+
+ +

Методы

+ +

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

+ +
+
{{ domxref("Range.setStart()")}}
+
Назначают начальную позицию Range.
+
{{ domxref("Range.setEnd()")}}
+
Назначает конечную позицию Range.
+
{{ domxref("Range.setStartBefore()")}}
+
Устанавливает начальную позицию Range относительно другого {{ domxref("Node") }} пред ним.
+
{{ domxref("Range.setStartAfter()")}}
+
Устанавливает начальную позицию Range относительно другого {{ domxref("Node") }} после него.
+
{{ domxref("Range.setEndBefore()")}}
+
Устанавливает конечную позицию Range относительно другого {{ domxref("Node") }} перед ним.
+
{{ domxref("Range.setEndAfter()")}}
+
Устанавливает конечную позицию Range относительно другого {{ domxref("Node") }} после него.
+
{{ domxref("Range.selectNode()")}}
+
Выбирает Range to содержащий {{ domxref("Node") }} и его контент.
+
{{ domxref("Range.selectNodeContents()")}}
+
Выбирает Range содержащий контент {{ domxref("Node") }}.
+
{{ domxref("Range.collapse()")}}
+
Схлопавыет Range до одной из граничных точек.
+
{{ domxref("Range.cloneContents()")}}
+
Возвращает {{ domxref("DocumentFragment") }} содержащийся в узле Range.
+
{{ domxref("Range.deleteContents()")}}
+
Удаляет содержимое Range из{{ domxref("Document") }}.
+
{{ domxref("Range.extractContents()")}}
+
Переносит содержимое Range из дерева документа в {{ domxref("DocumentFragment") }}.
+
{{ domxref("Range.insertNode()")}}
+
Вставляет a {{ domxref("Node") }} в начало Range.
+
{{ domxref("Range.surroundContents()")}}
+
Переносит содержимое Range в новый {{ domxref("Node") }}.
+
{{ domxref("Range.compareBoundaryPoints()")}}
+
Сравнивает граничные точки Range с другим Range.
+
{{ domxref("Range.cloneRange()")}}
+
Возвращает  объект из Range с граничными точками идентичными клонированному Range.
+
{{ domxref("Range.detach()")}}
+
Освобождает Range от использования для улучшения производительности .
+
{{ domxref("Range.toString()")}}
+
Возвращает текст в Range.
+
{{ domxref("Range.compareNode()")}} {{ Obsolete_inline }}{{non-standard_inline}}
+
Возвращает константу, представляющую, находится ли {{domxref("Node")}} до, после, внутри или вокруг  range.
+
{{ domxref("Range.comparePoint()")}} {{experimental_inline}}
+
Возвращает -1, 0, или 1 в зависимости от того, находиться ли referenceNode перед, внутри, или после  Range.
+
{{ domxref("Range.createContextualFragment()")}}{{experimental_inline}}
+
Возвращает {{ domxref("DocumentFragment") }} созданный из полученной строки с кодом.
+
{{ domxref("Range.getBoundingClientRect()") }} {{experimental_inline}}
+
Возвращает объект {{ domxref("ClientRect") }} object which bounds the entire contents of the Range; this would be the union of all the rectangles returned by {{ domxref("range.getClientRects()") }}.
+
{{ domxref("Range.getClientRects()") }} {{experimental_inline}}
+
Returns a list of {{ domxref("ClientRect") }} objects that aggregates the results of {{ domxref("Element.getClientRects()") }} for all the elements in the Range.
+
{{ domxref("Range.intersectsNode()")}} {{experimental_inline}}
+
Возвращает boolean указывающий, пересекает ли данный узел Range.
+
{{ domxref("Range.isPointInRange()")}} {{experimental_inline}}
+
Returns a boolean indicating whether the given point is in the Range.
+
+ +

Specifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#interface-range', 'Range')}}{{Spec2('DOM WHATWG')}}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().
{{SpecName('DOM Parsing', '#extensions-to-the-range-interface', 'Extensions to Range')}}{{Spec2('DOM Parsing')}}Added the method createContextualFragment().
{{SpecName('CSSOM View', '#extensions-to-the-range-interface', 'Extensions to Range')}}{{Spec2('CSSOM View')}}Added the methods getClientRects() and getBoundingClientRect().
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level-2-Range-Interface', 'Range')}}{{Spec2('DOM2 Traversal_Range')}}Initial specification.
+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.0")}} [1]9.09.0{{CompatVersionUnknown}}
Range() constructor {{experimental_inline}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("24.0")}}{{CompatNo}}15.0{{CompatVersionUnknown}}
compareNode() {{obsolete_inline}}{{non-standard_inline()}}{{CompatNo}}{{CompatGeckoDesktop("1.0")}}
+ Removed in {{CompatGeckoDesktop("1.9")}}		{{CompatNo}}{{CompatNo}}{{CompatNo}}
isPointInRange(), and comparePoint(){{experimental_inline}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}15.0{{CompatUnknown}}
intersectsNode() {{experimental_inline}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("17.0")}} [2]{{CompatNo}}15.0{{CompatUnknown}}
getClientRects() and getBoundingClientRect(){{experimental_inline}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}915.05
createContextualFragment(){{experimental_inline}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}15.0{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatVersionUnknown}}{{CompatGeckoMobile("1.0")}} [1]9.09.0{{CompatVersionUnknown}}
+
+ +

[1] Starting with Gecko 13.0 {{ geckoRelease("13.0") }} the Range object throws a {{ domxref("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

+ + -- cgit v1.2.3-54-g00ecf