--- title: range slug: Web/API/Range tags: - DOM - Dokumentacja_Gecko_DOM - Gecko - Strony_wymagające_dopracowania - Wszystkie_kategorie translation_of: Web/API/Range ---

{{ ApiRef("DOM") }}Obiekt Range reprezentuje fragment dokumentu, który stanowi węzeł oraz część węzła tekstowego w danym dokumencie.

A range can be created using the createRange method of the Document object. Range objects can also be retrieved by using the getRangeAt method of the selection object.

Własności

collapsed
Returns a boolean indicating whether the range's start and end points are at the same position.
commonAncestorContainer
Returns the deepest Node that contains the startContainer and endContainer Nodes.
endContainer
Returns the Node within which the Range ends.
endOffset
Returns a number representing where in the endContainer the Range ends.
startContainer
Returns the Node within which the Range starts.
startOffset
Returns a number representing where in the startContainer the Range starts.

Metody

Metody pozycjonowania

Te metody ustawiają punkt początkowy i końcowy obiektu range.

setStart
Ustawia pozycję początkową obiektu range.
setEnd
Ustawia pozycję końcową obiektu range.
setStartBefore
Ustawia pozycję początkowa dla obiektu range w odniesieniu do innego węzła.
setStartAfter
Ustawia pozycję początkowa dla obiektu range w odniesieniu do innego węzła.
setEndBefore
Ustawia pozycję końcową dla obiektu range w odniesieniu do innego węzła.
setEndAfter
Ustawia pozycję końcową dla obiektu range w odniesieniu do innego węzła.
selectNode
Ustawia obiekt range, aby zawierał węzeł wraz z jego zawartością.
selectNodeContents
Ustawia obiekt range, aby zawierał zawartość węzła.
collapse
Zawija obiekt range do jednego z jego punktów granicznych.

Metody edytujące

These methods retrieve Nodes from a range and modify the contents of a range.

cloneContents
Returns a document fragment copying the nodes of a Range.
deleteContents
Removes the contents of a Range from the document.
extractContents
Moves contents of a Range from the document tree into a document fragment
insertNode
Insert a node at the start of a Range.
surroundContents
Moves content of a Range into a new node.

Inne metody

compareBoundaryPoints
Porównuje punkty graniczne dwóch obiektów range.
cloneRange
Zwraca obiekt range z punktami granicznymi identycznymi z klonowanym obiektem range.
detach
Releases Range from use to improve performance.
toString
Zwraca tekst z obiektu range.

Metody Gecko

Ta sekcja opisuje szczególne metody Range Mozilli nie będące częścią specyfikacji W3C DOM.

compareNode {{ Obsolete_inline() }}
Zwraca stałą opisującą czy węzeł znajduje się przed, za, wewnątrz lub otacza obiekt range .
comparePoint
Zwraca -1, 0 lub 1 wskazując czy punkt porównania występuje przed, wewnątrz lub za obiektem range.
createContextualFragment
Zwraca fragment dokumentu utworzony z danego łańcucha kodu.
intersectsNode {{ Obsolete_inline() }}
Zwraca wartość Boolean określającą czy dany węzeł przecina obiekt range.
isPointInRange
Zwraca wartość Boolean określającą czy dany punkt jest zawarty w obiekcie range.