Range
DOM
DOM
The Range interface represents a fragment of a document that can contain nodes and parts of text nodes.
A range can be created by using the Document.createRange() method. Range objects can also be retrieved by using the getRangeAt() method of the Selection object or the caretRangeFromPoint() method of the Document object.
There also is the Range() constructor available.
Constructor
- Range()
- : Returns a
Rangeobject with the global Document as its start and end.
Instance properties
Also inherits properties from its parent interface, AbstractRange.
- Range.commonAncestorContainer
- : Returns the deepest Node that contains the
startContainerandendContainernodes.
Instance methods
There are no inherited methods.
- Range.collapse()
- : Collapses the
Rangeto one of its boundary points. - Range.compareBoundaryPoints()
- : Compares the boundary points of the
Rangewith anotherRange. - Range.compareNode()
- : Returns a constant representing whether the Node is before, after, inside, or surrounding the range.
- Range.comparePoint()
- : Returns -1, 0, or 1 indicating whether the point occurs before, inside, or after the
Range. - Range.cloneContents()
- : Returns a DocumentFragment copying the nodes of a
Range. - Range.cloneRange()
- : Returns a
Rangeobject with boundary points identical to the clonedRange. - Range.createContextualFragment()
- : Returns a DocumentFragment created from a given string of code.
- Range.deleteContents()
- : Removes the contents of a
Rangefrom the Document. - Range.detach()
- : Does nothing. Kept for compatibility.
- Range.extractContents()
- : Moves contents of a
Rangefrom the document tree into a DocumentFragment. - Range.getBoundingClientRect()
- : Returns a DOMRect 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 DOMRect objects that aggregates the results of Element.getClientRects() for all the elements in the
Range. - Range.isPointInRange()
- : Returns a
booleanindicating whether the given point is in theRange. - Range.insertNode()
- : Insert a Node at the start of a
Range. - Range.intersectsNode()
- : Returns a
booleanindicating whether the given node intersects theRange. - Range.selectNode()
- : Sets the
Rangeto contain the Node and its contents. - Range.selectNodeContents()
- : Sets the
Rangeto contain the contents of a Node. - Range.setEnd()
- : Sets the end position of a
Range. - Range.setStart()
- : Sets the start position of a
Range. - Range.setEndAfter()
- : Sets the end position of a
Rangerelative to another Node. - Range.setEndBefore()
- : Sets the end position of a
Rangerelative to another Node. - Range.setStartAfter()
- : Sets the start position of a
Rangerelative to another Node. - Range.setStartBefore()
- : Sets the start position of a
Rangerelative to another Node. - Range.surroundContents()
- : Moves content of a
Rangeinto a new Node. - Range.toString()
- : Returns the text of the
Range.