DIV CSS 佈局教程網

jQuery 判斷選取範圍(Selection)是否落在指定容器內
編輯:關於JavaScript     

實作「選字後跳出工具列」這類功能時,第一個要確認的就是:使用者目前選取的文字,到底在哪個容器裡?如果選到的是頁面其他區域,工具列就不該出現。

取得選取範圍並判斷所屬容器

 var range = document.getSelection().getRangeAt(0);

 if ($(range.startContainer).parents("XXXX").length > 0) {
   // 選取範圍確實在 XXXX 容器內
 }

把 XXXX 換成你的容器選擇器(例如 #editor 或 .article-body)即可。

逐步拆解

1. document.getSelection() 取得目前的 Selection 物件,代表使用者在頁面上選起的內容。

2. .getRangeAt(0) 取出第一個 Range。一個 Range 有 startContainer 與 endContainer,分別是選取範圍的起點與終點所在的 DOM 節點。

3. $(node).parents(selector) 沿著 DOM 樹往上一層層找祖先元素。注意 parents() 不包含節點本身;若希望連自己一起比對,該用 closest()。

4. 判斷 .length > 0 就知道有沒有找到符合的祖先。

更嚴謹的寫法

只檢查 startContainer 是不夠的——使用者完全可能從容器內起選、拖到容器外結束。要確認整段選取都被包住,得同時檢查兩端:

 var sel = document.getSelection();
 if (sel.rangeCount === 0) return false;   // 沒有任何選取

 var range = sel.getRangeAt(0);
 var startInside = $(range.startContainer).closest("#editor").length > 0;
 var endInside   = $(range.endContainer).closest("#editor").length > 0;

 if (startInside && endInside) {
   // 整段選取都在容器內
 }

幾個實務細節

先檢查 rangeCount。若使用者還沒選任何東西,getSelection().getRangeAt(0) 會丟出例外。務必先判斷。

節點可能是文字節點。startContainer 有可能是純文字節點而非元素。jQuery 的 closest() / parents() 對文字節點會找不到祖先,遇到這種情況要改用 range.startContainer.parentElement 先取得父元素。

rangeCount 可能大於 1。在 Firefox 等瀏覽器上,按住 Ctrl 可以有多段選取。若在意這種情況,得逐一檢查每個 range。

監聽 mouseup 而非 click。選取動作是在放開滑鼠時才完成的,所以工具列通常綁在 mouseup 或 selectionchange 事件上。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved