Selection: setPosition() method
The Selection.setPosition()
method collapses the current selection to a single point. The document is not modified. If the content is focused and editable, the caret will blink there.
Note: This method is an alias for the Selection.collapse()
method.
Syntax
js
setPosition(node)
setPosition(node, offset)
Parameters
node
-
The caret location will be within this node. This value can also be set to
null
— ifnull
is specified, the method will behave likeSelection.removeAllRanges()
, i.e. all ranges will be removed from the selection. offset
Optional-
The offset in
node
to which the selection will be collapsed. If not specified, the default value0
is used.
Return value
None (undefined
).
Examples
js
// Place the caret at the beginning of an HTML document's body.
const body = document.querySelector("body");
window.getSelection().setPosition(body, 0);
Specifications
Specification |
---|
Selection API # dom-selection-collapse |
Browser compatibility
BCD tables only load in the browser