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:
truecollapses theRangeto its start,falseto 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 | Status | Comment |
|---|---|---|
| DOM The definition of 'Range.collapse()' in that specification. |
Living Standard | The parameter is now optional and default to false. |
| Document Object Model (DOM) Level 2 Traversal and Range Specification The definition of 'Range.collapse()' in that specification. |
Recommendation | Initial specification. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | (Yes) | 1.0 (1.7 or earlier) | 9.0 | 9.0 | (Yes) |
| Parameter optional | (Yes) | 25 (25) | Not supported[1] | 15.0 | (Yes) |
| Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | (Yes) | 1.0 (1.0) | 9.0 | 9.0 | (Yes) |
| Parameter optional | (Yes) | 25 (25) | Not supported[1] | 15.0 | (Yes) |
[1] Optional but defaults to true.
See also
Document Tags and Contributors
Tags:
Contributors to this page:
Sebastianz,
teoli,
fscholz,
afreen,
shubham.hatwar,
Sheppy,
ethertank,
SkyLined,
Gor1
Last updated by:
Sebastianz,