Range 对象的使用

发表于 分类于 Disqus： 本文字数： 256 阅读时长 ≈ 1 分钟

什么是 Range 对象

Range 是指 html 文档中的区域，如用户用鼠标拖动选中的区域，如下图：

通过 Range 对象，可以获取用户选中的区域，或者指定选中区域，得到 Range 的起点和终点、修改或者复制里边的文本，甚至是 html。在富文本编辑器开发中，经常会使用到这些功能。

获取当前的选区

由于兼容性的问题，需要区分 IE 浏览器。

1
2
3
4
5
6
7
8
9
10
11
var selection, range;
if (window.getSelection) {
    //现代浏览器
    selection = window.getSelection();
} else if (document.selection) {
    //IE
    selection = document.selection.createRange();
}

//Range对象
range = selection.getRangeAt(0);

Range 对象的属性

属性描述
collapsed如果范围的开始点和结束点在文档的同一位置，则为 true，即范围是空的，或折叠的。
commonAncestorContainer范围的开始点和结束点的（即它们的祖先节点）、嵌套最深的 Document 节点。
endContainer包含范围的结束点的 Document 节点。
endOffsetendContainer 中的结束点位置。
startContainer包含范围的开始点的 Document 节点。
startOffsetstartContainer 中的开始点位置。

Range 对象的操作

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
//选中区域的文字
var text = range.toString();

//选中区域的Element元素
var elem = range.commonAncestorContainer;
if (elem.nodeType != 1) {
    elem = elem.parentNode;
}

//选中区域的html
var span = document.createElement('SPAN');
span.appendChild(range.cloneContents());

//选区是否为空
var isSelectionEmpty = false;
if (range.startContainer === range.endContainer) {
    if (range.startOffset === range.endOffset) {
        isSelectionEmpty = true;
    }
}

参考文章：JS Range 对象的使用