此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Selection:collapse() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

Selection.collapse() 方法会将当前选区折叠为单个点。文档内容不会被修改。如果当前内容处于可编辑并获得焦点的状态,光标会在该位置闪烁。

备注:该方法是 Selection.setPosition() 方法的别名。

语法

js
collapse(node)
collapse(node, offset)

参数

node

光标将位于此节点内。该值也可以设为 null——如果为 null ,方法行为将与 Selection.removeAllRanges() 相同,即移除选区中的所有范围。

offset 可选

选区将折叠到 node 中的此偏移位置。如果未指定,则使用默认值 0

返回值

无(undefined)。

示例

js
// 将光标放置在 HTML 文档 body 的起始位置。
const body = document.querySelector("body");
window.getSelection().collapse(body, 0);

规范

Specification
Selection API
# dom-selection-collapse

浏览器兼容性

参见