###選區API 以下是與選擇區域有關的API，**下面有些API在IE8、9可能無效，但是不會報錯**。 *使用下面的API，最好要了解一下`javascript`的`range`和`selection`的基礎知識。如果要兼容IE8、9，還有了解IE8、9特有的`selection`和 `textRange`的知識。* ----- - **`editor.currentRange`** 獲取或者設置當前的選中區域，例如 ```js var range = editor.currentRange(); // 獲取 editor.currentRange(range); // 設置 ``` ----- - **`editor.collapseRange`** 折疊傳入的選區，或者當前選區。例如： ```js editor.collapseRange(); // 折疊當前選區，到結束位置 editor.collapseRange(range); // 折疊傳入的選區，到結束位置 editor.collapseRange(null, 'start'); // 折疊當前選區，到開始位置 editor.collapseRange(range, 'start'); // 折疊傳入的選區，到開始位置 ``` ----- - **`editor.getRangeText`** 獲取當前選區的文字內容，例如 ```js var rangeText = editor.getRangeText(); ``` ----- - **`editor.getRangeElem`** 獲取當前選區所在的容器元素，不會是`text node`，而是`elem node`。例如 ```js var elem = editor.getRangeElem(); ``` ----- - **`editor.isRangeEmpty`** 判斷當前選區有沒有選中文字內容。**說明：如果鼠標拖拽選擇了若干個文字，那就是有選中內容；如果鼠標點擊了某個地方，為選中文字，只有光標閃爍，那就是無選中內容** ```js if ( editor.isRangeEmpty() ) { console.log('當前選區無選中內容'); } ``` ----- - **`editor.saveSelection`** 將傳入的選區對象或者從瀏覽器捕獲的選區，保存為編輯器的當前選區。 ```js editor.saveSelection(); // 捕獲瀏覽器的選區，保存 editor.saveSelection(range); //將傳入的選區對象，保存為當前選區 ``` ----- - **`editor.restoreSelection`** 將編輯器的當前選區，或者傳入的選區對象，恢復為瀏覽器能看得見的選擇區域。 ```js editor.restoreSelection(); // 恢復當前選區為瀏覽器的選擇區域 editor.restoreSelection(range); // 將傳入的選區對象，恢復為瀏覽器的選擇區域 ``` ----- - **`editor.restoreSelectionByElem`** 將傳入的`elem`元素，作為選區，恢復為瀏覽器的選擇區域。 ```js // 獲取編輯器的最后一個 p 元素 var $p = editor.$txt.find('p').last(); var p = $p.get(0); if (!p) { return; } editor.restoreSelectionByElem(p); // 回復選區至最后一個 p，折疊到結束位置結束位置 editor.restoreSelectionByElem(p, 'start'); // 回復選區至最后一個 p，折疊到結束位置開始位置 ```