StaticRange
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.
The DOM StaticRange interface extends AbstractRange to provide a method to specify a range of content in the DOM whose contents don't update to reflect changes which occur within the DOM tree.
This interface offers the same set of properties and methods as AbstractRange.
AbstractRange and StaticRange are not available from web workers.
Constructor
StaticRange()-
Creates a new
StaticRangeobject given options specifying the default values for its properties.
Instance properties
Inherits properties from its parent interface, AbstractRange.
Usage notes
A DOM range specifies a span of content in a document, potentially beginning inside one node (or element) and ending inside another one. Unlike a Range, a StaticRange represents a range which is fixed in time; it does not change to try to keep the same content within it as the document changes. If any changes are made to the DOM, the actual data contained within the range specified by a StaticRange may change. This lets the user agent avoid a lot of work that is unnecessary if the web app or site doesn't need a live-updating range.
Specifications
| Specification |
|---|
| DOM # interface-staticrange |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
StaticRange
|
|
|
|
|
|
|
|
|
|
|
|
|
StaticRange() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
collapsed
|
|
|
|
|
|
|
|
|
|
|
|
|
endContainer
|
|
|
|
|
|
|
|
|
|
|
|
|
endOffset
|
|
|
|
|
|
|
|
|
|
|
|
|
startContainer
|
|
|
|
|
|
|
|
|
|
|
|
|
startOffset
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.
See also
- Live updating range of content within the DOM:
Range AbstractRange, the abstract interface from which all ranges are derived