Range.collapse()
The Range.collapse()
method collapses the Range
to one of its boundary points.
A collapsed Range
is empty, containing no content, specifying a single-point in a DOM tree. To determine if a Range
is already collapsed, see the Range.collapsed
property.
Syntax
range.collapse(toStart);
Parameters
-
toStart
Optional -
A boolean value:
true
collapses theRange
to its start,false
to its end. If omitted, it defaults tofalse
.
Example
var range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.selectNode(referenceNode); range.collapse(true);
Specifications
Specification |
---|
DOM Standard (DOM) # dom-range-collapse |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
collapse |
1 |
12 |
1 |
9 |
9 |
1 |
1 |
18 |
4 |
10.1 |
1 |
1.0 |
toStart_parameter_optional |
Yes |
≤79 |
25 |
No
Optional but defaults to
true . |
15 |
Yes |
Yes |
Yes |
25 |
14 |
Yes |
Yes |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Range/collapse