org.w3c.dom.ranges
public interface Range
See also the Document Object Model (DOM) Level 2 Traversal and Range Specification.
Since: DOM Level 2
| Field Summary | |
|---|---|
| static short | END_TO_END
Compare end boundary-point of sourceRange to end
boundary-point of Range on which compareBoundaryPoints
is invoked. |
| static short | END_TO_START
Compare end boundary-point of sourceRange to start
boundary-point of Range on which compareBoundaryPoints
is invoked. |
| static short | START_TO_END
Compare start boundary-point of sourceRange to end
boundary-point of Range on which compareBoundaryPoints
is invoked. |
| static short | START_TO_START
Compare start boundary-point of sourceRange to start
boundary-point of Range on which compareBoundaryPoints
is invoked. |
| Method Summary | |
|---|---|
| DocumentFragment | cloneContents()
Duplicates the contents of a Range |
| Range | cloneRange()
Produces a new Range whose boundary-points are equal to the
boundary-points of the Range. |
| void | collapse(boolean toStart)
Collapse a Range onto one of its boundary-points |
| short | compareBoundaryPoints(short how, Range sourceRange)
Compare the boundary-points of two Ranges in a document. |
| void | deleteContents()
Removes the contents of a Range from the containing document or
document fragment without returning a reference to the removed
content. |
| void | detach()
Called to indicate that the Range is no longer in use and that the
implementation may relinquish any resources associated with this
Range. |
| DocumentFragment | extractContents()
Moves the contents of a Range from the containing document or document
fragment to a new DocumentFragment. |
| boolean | getCollapsed()
TRUE if the Range is collapsed |
| Node | getCommonAncestorContainer()
The deepest common ancestor container of the Range's two
boundary-points. |
| Node | getEndContainer()
Node within which the Range ends |
| int | getEndOffset()
Offset within the ending node of the Range. |
| Node | getStartContainer()
Node within which the Range begins |
| int | getStartOffset()
Offset within the starting node of the Range. |
| void | insertNode(Node newNode)
Inserts a node into the Document or DocumentFragment at the start of
the Range. |
| void | selectNode(Node refNode)
Select a node and its contents |
| void | selectNodeContents(Node refNode)
Select the contents within a node |
| void | setEnd(Node refNode, int offset)
Sets the attributes describing the end of a Range. |
| void | setEndAfter(Node refNode)
Sets the end of a Range to be after a node |
| void | setEndBefore(Node refNode)
Sets the end position to be before a node. |
| void | setStart(Node refNode, int offset)
Sets the attributes describing the start of the Range. |
| void | setStartAfter(Node refNode)
Sets the start position to be after a node |
| void | setStartBefore(Node refNode)
Sets the start position to be before a node |
| void | surroundContents(Node newParent)
Reparents the contents of the Range to the given node and inserts the
node at the position of the start of the Range. |
| String | toString()
Returns the contents of a Range as a string. |
sourceRange to end
boundary-point of Range on which compareBoundaryPoints
is invoked.sourceRange to start
boundary-point of Range on which compareBoundaryPoints
is invoked.sourceRange to end
boundary-point of Range on which compareBoundaryPoints
is invoked.sourceRange to start
boundary-point of Range on which compareBoundaryPoints
is invoked.Returns: A DocumentFragment that contains content equivalent to this Range.
Throws: DOMException
HIERARCHY_REQUEST_ERR: Raised if a DocumentType node would be
extracted into the new DocumentFragment.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object.
Returns: The duplicated Range.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Parameters: toStart If TRUE, collapses the Range onto its start; if FALSE, collapses it onto its end.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Parameters: how A code representing the type of comparison, as defined
above. sourceRange The Range on which this current
Range is compared to.
Returns: -1, 0 or 1 depending on whether the corresponding
boundary-point of the Range is respectively before, equal to, or
after the corresponding boundary-point of sourceRange.
Throws: DOMException
WRONG_DOCUMENT_ERR: Raised if the two Ranges are not in the same
Document or DocumentFragment.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object.
Throws: DOMException
NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of
the Range is read-only or any of the nodes that contain any of the
content of the Range are read-only.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object.
DOMException being thrown with an
error code of INVALID_STATE_ERR.Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Returns: A DocumentFragment containing the extracted contents.
Throws: DOMException
NO_MODIFICATION_ALLOWED_ERR: Raised if any portion of the content of
the Range is read-only or any of the nodes which contain any of the
content of the Range are read-only.
HIERARCHY_REQUEST_ERR: Raised if a DocumentType node would be
extracted into the new DocumentFragment.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
Parameters: newNode The node to insert at the start of the Range
Throws: DOMException
NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the
start of the Range is read-only.
WRONG_DOCUMENT_ERR: Raised if newNode and the
container of the start of the Range were not created from the same
document.
HIERARCHY_REQUEST_ERR: Raised if the container of the start of
the Range is of a type that does not allow children of the type of
newNode or if newNode is an ancestor of
the container.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object. RangeException
INVALID_NODE_TYPE_ERR: Raised if newNode is an Attr,
Entity, Notation, or Document node.
Parameters: refNode The node to select.
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if an ancestor of refNode
is an Entity, Notation or DocumentType node or if
refNode is a Document, DocumentFragment, Attr, Entity,
or Notation node. DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode Node to select from
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if refNode or an ancestor
of refNode is an Entity, Notation or DocumentType node. DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode The refNode value. This parameter must be
different from null. offset The endOffset value.
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if refNode or an ancestor
of refNode is an Entity, Notation, or DocumentType
node. DOMException
INDEX_SIZE_ERR: Raised if offset is negative or greater
than the number of child units in refNode. Child units
are 16-bit units if refNode is a type of CharacterData
node (e.g., a Text or Comment node) or a ProcessingInstruction
node. Child units are Nodes in all other cases.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode Range ends after refNode.
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if the root container of
refNode is not an Attr, Document or DocumentFragment
node or if refNode is a Document, DocumentFragment,
Attr, Entity, or Notation node. DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode Range ends before refNode
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if the root container of
refNode is not an Attr, Document, or DocumentFragment
node or if refNode is a Document, DocumentFragment,
Attr, Entity, or Notation node. DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode The refNode value. This parameter must be
different from null. offset The startOffset value.
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if refNode or an ancestor
of refNode is an Entity, Notation, or DocumentType
node. DOMException
INDEX_SIZE_ERR: Raised if offset is negative or greater
than the number of child units in refNode. Child units
are 16-bit units if refNode is a type of CharacterData
node (e.g., a Text or Comment node) or a ProcessingInstruction
node. Child units are Nodes in all other cases.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode Range starts after refNode
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if the root container of
refNode is not an Attr, Document, or DocumentFragment
node or if refNode is a Document, DocumentFragment,
Attr, Entity, or Notation node. DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: refNode Range starts before refNode
Throws: RangeException
INVALID_NODE_TYPE_ERR: Raised if the root container of
refNode is not an Attr, Document, or DocumentFragment
node or if refNode is a Document, DocumentFragment,
Attr, Entity, or Notation node. DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.
WRONG_DOCUMENT_ERR: Raised if refNode was created
from a different document than the one that created this range.
Parameters: newParent The node to surround the contents with.
Throws: DOMException
NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of
either boundary-point of the Range is read-only.
WRONG_DOCUMENT_ERR: Raised if newParent and the
container of the start of the Range were not created from the same
document.
HIERARCHY_REQUEST_ERR: Raised if the container of the start of
the Range is of a type that does not allow children of the type of
newParent or if newParent is an ancestor
of the container or if node would end up with a child
node of a type not allowed by the type of node.
INVALID_STATE_ERR: Raised if detach() has already
been invoked on this object. RangeException
BAD_BOUNDARYPOINTS_ERR: Raised if the Range partially selects a
non-text node.
INVALID_NODE_TYPE_ERR: Raised if node is an Attr,
Entity, DocumentType, Notation, Document, or DocumentFragment node.
Returns: The contents of the Range.
Throws: DOMException
INVALID_STATE_ERR: Raised if detach() has already been
invoked on this object.