Range 用來表示用戶的選擇區域。這塊區域由兩個邊界位置界定,而每個位置由「容器 + 偏移量」構成,即 container 與 offset。看個最簡單的例子:
<p><span>文字</span>^<span>文字</span></p>
其中 ^ 表示一個位置。此時 container 是父節點 p,offset 是相對於父節點的偏移量 1。
需要特別注意:當 container 是元素節點時,offset 的單位是「子節點」,即從容器的第一個子節點到當前位置所經歷的子節點個數。
相對地,container 也可以是文字節點。這時 offset 就是從該 textNode 到當前位置所經歷的 UTF-16 字符個數(意味著中英文計數一致,不是字節計數):
<p><span>文字</span><span>01234^567</span></p>
上例中 container 是 "01234567" 這個文字節點,offset 則是 5。
IE 的 TextRange 沒有清晰的「容器 + 偏移量」概念,但基本思想與 W3C Range 一致,具備同等的表達能力。它分為 TextRange 與 ControlRange 兩類,各自帶著一系列方法。
TextRange 不是字面意義上的「純文本」,它表示用戶的選擇區域內容(可用 htmlText 拿到完整 HTML),操作方式大多以字符為單位而不是 DOM 樹節點。
ControlRange 顧名思義用來獲取選中的「控件」——某些元素(div、img、object 等)處於可編輯狀態時,單擊可以整塊選中,這時拿到的就是 ControlRange。
W3C Range 的 container / offset 模型更規範也更直觀。當我們需要對 Range 關聯的 DOM 節點做操作時,這兩個值必不可少。既然 IE Range 具備等價表達能力,那麼就可以用它提供的方法反推出這兩個關鍵變量。
有兩種途徑。從當前選擇區域獲取:
document.selection.createRange()
它會根據目前的選擇返回 TextRange 或 ControlRange 實例。
從元素創建:
oControlRange = object.createControlRange() oTextRange = object.createTextRange()
前一種只能在 body 或 element 上調用,後一種可在大多數元素上調用。調用後該範圍會完全覆蓋調用元素,效果相當於 moveToElementText。
collapse(bool):根據參數把結束位置重合到開始位置(true),或把開始位置重合到結束位置(false)。
parentElement():獲取包圍選擇區域的元素節點。例如對 <span>文^字</span> 調用後得到 span 節點。
moveToElementText(node):把選擇區域變更為該元素,起始位置落在它的前後:
^<span>文字</span>^
range1.compareEndPoints('XxToYy', range2):xx、yy 可以是 Start 或 End,取 range1 的 xx 位置與 range2 的 yy 位置比較,按前後順序返回 -1、1,重合返回 0。
range1.setEndPoint("XxToYy", range2):把 range1 的 xx 位置設為 range2 的 yy 位置。
有了上面這幾個方法,就能開始標準化的第一步:獲取位置。

(綠塊表示文字節點。注意:正常手工編寫頁面不會出現兩個相鄰的文字節點,這裡是用 splitText 強制分離的。)
當我們把選擇區域 collapse 之後,可能落在四個位置:1、2、3、4。其中 1 和 4 因為緊鄰元素節點,處理起來最簡單。
思路是:用 parentElement 拿到包含該位置的節點 p(它就是 container),然後逐一驗證 p 的所有元素子節點是否與已知位置相鄰。驗證方法是先用 moveToElementText 新建一個包住子節點的 range,再用 compareEndPoints 判斷新 range 的前後邊界是否與當前位置重合:
range = range.duplicate();
range.collapse(start);
var parent = range.parentElement(),
siblings = parent.childNodes;
for (var i = 0; i < siblings.length; i++) {
var child = siblings[i];
if (child.nodeType == 1) {
var tr = range.duplicate();
tr.moveToElementText(child);
// 子元素節點開始位置比較
var comparisonStart = tr.compareEndPoints('StartToStart', range),
// 子元素節點結束位置比較
comparisonEnd = tr.compareEndPoints('EndToStart', range);
// 開頭已經在當前位置後面,沒必要繼續比了
if (comparisonStart > 0) break;
else if (!comparisonStart ||
comparisonEnd == 1 && comparisonStart == -1)
return { container: parent, offset: i };
else if (!comparisonEnd)
return { container: parent, offset: i + 1 };
}
}
位置 2 表示落在兩個文字節點之間,此時 container 是 p;位置 3 表示落在文本節點中間,此時 container 是那個文本節點,offset 要數字符數。
由於 moveToElementText 無法作用在文字節點上,只能換個思路——用字符總數做減法:
示例:
<p id="test"><strong>粗體</strong>普通|文字<i>斜體</i></p>
<script>
document.getElementById("test").childNodes[1].splitText(2);
</script>
這個就簡單多了:用 item(index) 拿到選中的元素,結合它的 parentNode,就得到了標準化的 container 與 offset 表示。
規範規定輸入框的選擇區域與頁面選擇區域是相互分離的,因此輸入框有自己的一套獲取方式(IE 的寫法基本相同)。做富文本或者代碼編輯器一類的功能時,這部分需要單獨處理,不能與頁面 Range 混用。