范围和选择 API

### saveRange
参考 #saveRange

### restoreRange
参考 #restorerange

### getLastRange
Summernote 正在保存当前光标上的范围对象（WrappedRange）。

> ```javascript
const rng = $('#summernote').summernote('editor.getLastRange');
```
**当 summernote 使用 dom 事件保存范围时**
- keydown
- keyup
- focus
- mouseup
- paste
**当 summernote 使用 api 保存范围时**
- `editor.insertImage` -> Image
- `editor.insertNode` -> Node
- `editor.insertText` -> TextNode
- `editor.pasteHTML` -> last Node of contents
- `editor.insertHorizontalRule` -> next sibling node of hr node
- `editor.createLink` -> link node

### setLastRange
您可以在 summernote 可编辑元素的节点中定义自定义范围。

```javascript
const range = $.summernote.range;  // range utility
// set my custom range
$('#summernote').summernote('editor.setLastRange', range.createFromNodeAfter(node).select());
```
### range utility
```javascript
const range = $.summernote.range;  // range utility
```
### create WrappedRange Object
范围实用程序使 WrappedRange 类的实例。

#### create
从参数或浏览器选择创建 WrappedRange 对象。

```javascript
const rng = range.create(startContainer, startOffset, endContainer, endOffset)

// or

const rng = range.create() //  is equals range.createFromSelection()
```
#### createFromNode
从节点创建 WrappedRange 对象。

```javascript
const rng = range.createFromNode(node)
```
#### createFromNodeBefore
从位置前的节点创建 WrappedRange。

```javascript
const rng = range.createFromNodeBefore(node)
```
#### createFromNodeAfter
从位置后的节点创建 WrappedRange。

```javascript
const rng = range.createFromNodeAfter(node)
```
#### createFromSelection
从选区创建 WrappedRange 对象。

```javascript
const rng = range.createFromSelection(node)
```
### WrappedRange Object
#### eselect()
选择更新可见范围。

```javascript
rng.select()
```
#### collapse(isCollapseToStart)
```javascript
const newRng = rng.collapse(true);   // to start rng

const newRng = rng.collapse();  // to end rng
```
#### splitText()
范围内的 `splitText`。

```javascript
const textRng = rng.splitText()
```
#### deleteContents()
删除范围内的内容。

```javascript
const newRng = rng.deleteContents()
```
#### isCollapsed()
返回范围是否被折叠。

```javascript
const isCollapsed = rng.isCollapsed()
```
#### wrapBodyInlineWithPara()
用段落将 `body` 的子节点换行。

```javascript
const newRng = rng.wrapBodyInlineWithPara()
```
#### insertNode(node)
在当前光标处插入节点。

```javascript
const node = rng.insertNode(document.createElement('div'))
```
#### pasteHTML(markup)
在当前光标处插入 html。

```javascript
const nodes = rng.pasteHTML(`<div>summernote</div>`)
```
#### toString()
返回范围内的文本。

#### getWordRange(findAfter)
返回光标前（或后）字的范围。

```javascript
const newRng = rng.getWordRange();   // before cursor

// or

const newRng = rng.getWordRange(true);   // after cursor
```
#### getWordsMatchRange(regex)
返回光标前与 Regex 匹配的字词范围

```javascript
// range : 'hi @Peter Pan'
const rng = range.create() // or $('.summernote').summernote('getLastRange');

const newRng = rng.getWordsMatchRange(/@[a-z ]+/i)

console.log(newRng.toString())  // '@Peter Pan'
```
#### getClientRects()
返回一个 DOMRect 对象列表，该列表表示范围所占屏幕的区域。

> **Range.getClientRects()**
https://developer.mozilla.org/en-US/docs/Web/API/Range/getClientRects