平武建站

JavaScript如何操作光标和选区

这篇“JavaScript如何操作光标和选区”文章的知识点大部分人都不太理解，所以小编给大家总结了以下内容，内容详细，步骤清晰，具有一定的借鉴价值，希望大家阅读完这篇文章能有所收获，下面我们一起来看看这篇“JavaScript如何操作光标和选区”文章吧。

创新互联建站的客户来自各行各业，为了共同目标，我们在工作上密切配合，从创业型小企业到企事业单位，感谢他们对我们的要求，感谢他们从不同领域给我们带来的挑战，让我们激情的团队有机会用头脑与智慧不断的给客户带来惊喜。专业领域包括成都网站建设、网站建设、电商网站开发、微信营销、系统平台开发。

在一些业务场景，比如高亮文本、输入编辑、等场景中需要对光标和选区进行操作时，可以使用浏览器提供的 Selection 对象和 Range 对象来操作光标和选区。

Selection 对象

Selection 对象表示用户选择的选区或插入符号的当前位置，它可能横跨多个元素。

//获取 Selection 对象
window.getSelection();

用户可能从左到右（与文档方向相同）选择文本或从右到左（与文档方向相反）选择文本。

anchor （锚点）： 指用户开始选择的地方。
focus （焦点）： 指用户结束选择的地方。

如果你使用鼠标选择文本的话，anchor 就指你按下鼠标键的地方，而 focus 就指你松开鼠标键的地方。anchor 和 focus 的概念不能与选区的起始位置和终止位置混淆，因为 anchor 可能在 focus 的前面，也可能在 focus 的后面，这取决于你选择文本时鼠标移动的方向，也就是按下鼠标键和松开鼠标键的位置。

如下图所示：

JavaScript如何操作光标和选区

属性：

anchorNode： 锚点（anchor）所在节点。
anchorOffset：

如果 anchorNode 是文本节点、注释节点，返回锚点（anchor）到该节点中第一个字的字符个数。
如果 anchorNode 是元素节点，返回锚点（anchor）之前的同级节点总数。

focusNode： 焦点（focus）所在节点。
focusOffset：

如果 focusNode 是文本节点、注释节点，返回焦点（focus）到该节点中的第一个字的字符个数。
如果 focusNode 是元素节点，返回焦点（focus）之前的同级节点总数。

isCollapsed： 表示选区的起始位置和终止位置是否重合的 Boolean 值，如果为 true，可以认为当前没有内容选中。
rangeCount： 选区中包含的 Range 对象数量。
type： 描述当前选区的类型，有以下三个值：

None： 当前没有选择。
Caret： 仅单击，但未选择，选区已折叠（即光标在字符之间，并未处于选中状态）。
Range： 选择的是一个范围。

注意：

以上所有属性都是只读属性。

方法：

addRange(range)

向选区（Selection 对象）中添加一个区域（ Range 对象）。

参数：

range：一个区域对象

示例：

文本

//添加一个选区
var text = document.querySelector("#text");
var selObj = window.getSelection();
var rangeObj = document.createRange();
rangeObj.selectNode(text);
selObj.addRange(rangeObj);

collapse(parentNode,offset)
收起当前选区到一个点。文档不会发生改变。
参数：
parentNode：光标落在的目标节点
offset：可选，在目标节点内的偏移量
示例：
```
文本
```

//收起选区到一个点，光标落在一个可编辑元素上
var text = document.querySelector("#text")
window.getSelection().collapse(text,0);

collapseToEnd()

取消当前选区，并把光标定位在原选区的最末尾处。

参数：

无

示例：

var selObj = window.getSelection();
selObj.collapseToEnd();

collapseToStart()

取消当前选区，并把光标定位在原选区的最开始处。

参数：

无

示例：

var selObj = window.getSelection();
selObj.collapseToStart();

containsNode(aNode,aPartlyContained)

判断指定的节点是否包含在 Selection 对象中（即是否被选中）。

参数：

aNode：用于判断是否包含在 Selection 对象中的节点。
aPartlyContained：
当此参数为 true 时，Selection 对象包含 aNode 的一部分或全部时，containsNode() 方法返回true。
当此参数为 false （默认值）时，只有 Selection 对象完全包含 aNode 时，containsNode() 方法才返回 true。

示例：

文本

var text = document.querySelector("#text");
var selObj = window.getSelection();
var contains = selObj.containsNode(text);

deleteFromDocument()

从 DOM 中删除选中的文档片段。

参数：

无

示例：

var selObj = window.getSelection();
selObj.deleteFromDocument();

extend(node,offset)

移动选区的焦点（focus）到指定的点。选区的锚点（anchor）不会移动。选区将从锚点（anchor）开始到新的焦点（focus），不管方向。

参数：

node：焦点（focus）会被移至此节点内。
offset：可选，默认值为0，焦点（focus）会被移至 node 内的偏移位置。

示例：

文本

var text = document.querySelector("#text");
var selObj = window.getSelection();
selObj.extend(text);

getRangeAt(index)

返回一个当前选区包含的 Range 对象。

参数：

index：该参数指定 Range 对象的索引。如果该数值大于或等于 rangeCount ，将会报错。

示例：

//获取一个 Selection 对象
var selObj = window.getSelection();
//获取一个 Range 对象
var rangeObj  = selObj.getRangeAt(0);

modify(alter,direction,granularity)

通过文本命令来更改当前选区或光标位置。

参数：

alter：改变类型，传入 move 来移动光标位置，或者 extend 来扩展当前选区。
direction：调整选区的方向。你可以传入 forward 或 backward 来根据选区内容的语言书写方向来调整。或者使用 left 或 right 来指明一个明确的调整方向。
granularity：调整的距离颗粒度。可选值有 character、word、sentence、line、paragraph、lineboundary、sentenceboundary、paragraphboundary、documentboundary。

示例：

var selection = window.getSelection();
selection.modify("extend", "forward", "word");

removeAllRanges()
会从当前 Selection 对象中移除所有的 Range 对象，取消所有的选择。
参数：
无
示例：
```
var selObj = window.getSelection();
selObj.removeAllRanges();
```
removeRange(range)
将一个 Range 对象从选区中移除。
参数：
range：一个将从选区中移除的 Range 对象。
示例：
```
var selObj = window.getSelection();
var rangeObj = selObj.getRangeAt(0)
selObj.removeRange(rangeObj);
```

selectAllChildren(parentNode)
把指定元素的所有子元素设置为选区（该元素本身除外），并取消之前的选区。
参数：
parentNode：指定元素
示例：
```
  文本1
  文本2
```

示例：

Range 对象

Range 对象表示被选中的文档片段。一个 Range 对象可能包含整个元素节点，也可能包含元素节点的一部分，例如文本节点的一部分文字。用户通常只能选择一个 Range 对象，但是有的时候用户也有可能选择多个 Range 对象（只有火狐浏览器可以选择多个 Range 对象）。

可以用 Document 对象的 Document.createRange 方法创建 Range，也可以用 Selection 对象的 getRangeAt 方法获取 Range。另外，还可以通过 Document 对象的构造函数 Range() 来得到 Range。

属性：

方法：

// 在文档中插入选中元素 var selObj = window.getSelection(); var rangeObj = selObj.getRangeAt(0); documentFragment = rangeObj.cloneContents(); document.body.appendChild(documentFragment);

Range.END_TO_END ：比较 sourceRange 对象的结束位置节点和原 Range 对象的结束位置节点。 Range.END_TO_START ：比较 sourceRange 对象的结束位置节点和原 Range 对象的起始位置节点。 Range.START_TO_END ：比较 sourceRange 对象的起始位置节点和原 Range 对象的结束位置节点。 Range.START_TO_START ：比较 sourceRange 对象的起始位置节点和原 Range 对象的起始位置节点。

-1 ：原 Range 对象的比较节点在 sourceRange 对象的比较节点之前 0 ：原 Range 对象的比较节点在 sourceRange 对象的比较节点的相同位置 1 ：原 Range 对象的比较节点在 sourceRange 对象的比较节点之后

var range, sourceRange, compare; range = document.createRange(); range.selectNode(document.querySelector("#rang")); sourceRange = document.createRange(); sourceRange.selectNode(document.querySelector("#sourceRange")); compare = range.compareBoundaryPoints(Range.START_TO_END, sourceRange);

选区中的多个区域

一个 Selection 对象表示用户选择的区域（Range 对象）的集合，通常它只包含一个区域，访问方式如下：

修改选区样式

使用 ::selection 选择器可以匹配被选中的部分。
目前只有一小部分 CSS 属性可以用于 ::selection 选择器：

示例

以上就是关于“JavaScript如何操作光标和选区”这篇文章的内容，相信大家都有了一定的了解，希望小编分享的内容对大家有帮助，若想了解更多相关的知识内容，请关注创新互联行业资讯频道。

JavaScript如何操作光标和选区

Selection 对象

属性：

方法：

addRange(range)

参数：

示例：

collapse(parentNode,offset)

参数：

示例：

collapseToEnd()

参数：

示例：

collapseToStart()

参数：

示例：

containsNode(aNode,aPartlyContained)

参数：

示例：

deleteFromDocument()

参数：

示例：

extend(node,offset)

参数：

示例：

getRangeAt(index)

参数：

示例：

modify(alter,direction,granularity)

参数：

示例：

removeAllRanges()

参数：

示例：

removeRange(range)

参数：

示例：

selectAllChildren(parentNode)

参数：

示例：

setBaseAndExtent(anchorNode,anchorOffset,focusNode,focusOffset)

参数：

示例：

toString()

参数：

示例：

Range 对象

属性：

方法：

cloneContents()

参数：

示例：

cloneRange()

参数：

示例：

collapse(toStart)

参数：

示例：

compareBoundaryPoints(how, sourceRange)

参数：

返回值

示例：

comparePoint(referenceNode,offset)

参数：

示例：

createContextualFragment(tagString)

参数：

示例：

deleteContents()

参数：

示例：

extractContents()

参数：

示例：

getBoundingClientRect()

参数：

示例：

getClientRects()

参数：

示例：