选择:collapse() 方法

Selection.collapse() 方法将当前选择项折叠为单个点。文档不会修改。如果内容已聚焦且可编辑,则插入符号将在该处闪烁。

注意: 此方法是 Selection.setPosition() 方法的别名。

语法

js
collapse(node)
collapse(node, offset)

参数

node

插入符号位置将在该节点内。此值也可以设置为 null - 如果指定 null,该方法将类似于 Selection.removeAllRanges(),即所有范围将从选择项中移除。

offset 可选

node 中选择项将折叠到的偏移量。如果未指定,则使用默认值 0

返回值

无 (undefined).

示例

js
// Place the caret at the beginning of an HTML document's body.
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);

规范

规范
选择 API
# dom-selection-collapse

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅