DIV CSS 佈局教程網

Range 標準化實踐:如何從 IE TextRange 推出 container 與 offset
編輯:關於JavaScript     

W3C Range 的位置模型

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 Range 的特點

IE 的 TextRange 沒有清晰的「容器 + 偏移量」概念,但基本思想與 W3C Range 一致,具備同等的表達能力。它分為 TextRange 與 ControlRange 兩類,各自帶著一系列方法。

TextRange 不是字面意義上的「純文本」,它表示用戶的選擇區域內容(可用 htmlText 拿到完整 HTML),操作方式大多以字符為單位而不是 DOM 樹節點。

ControlRange 顧名思義用來獲取選中的「控件」——某些元素(div、img、object 等)處於可編輯狀態時,單擊可以整塊選中,這時拿到的就是 ControlRange。

標準化的思路

W3C Range 的 container / offset 模型更規範也更直觀。當我們需要對 Range 關聯的 DOM 節點做操作時,這兩個值必不可少。既然 IE Range 具備等價表達能力,那麼就可以用它提供的方法反推出這兩個關鍵變量。

獲取 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 因為緊鄰元素節點,處理起來最簡單。

位置 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、3 的標準化

位置 2 表示落在兩個文字節點之間,此時 container 是 p;位置 3 表示落在文本節點中間,此時 container 是那個文本節點,offset 要數字符數。

由於 moveToElementText 無法作用在文字節點上,只能換個思路——用字符總數做減法:

  1. 先移動到位置 1(元素節點邊界,容易確定)並停下。
  2. 新建 range ra,起點為位置 1,終點為位置 2 或 3,取得 ra 的字符總數 ra_textLength。
  3. 從位置 1 往右遍歷每個文字節點,從 ra_textLength 中減去該節點的長度(data.length)。
  4. 當 ra_textLength 恰好為 0 時,說明當前位置就是 2,而此時走過的文字節點數目即為 offset。
  5. 當 ra_textLength 變成負數時,說明當前位置是 3,當前這個文字節點就是 container,而上一次減法之前的 ra_textLength 值就是 offset。

示例:

<p id="test"><strong>粗體</strong>普通|文字<i>斜體</i></p>
<script>
document.getElementById("test").childNodes[1].splitText(2);
</script>

ControlRange 的標準化

這個就簡單多了:用 item(index) 拿到選中的元素,結合它的 parentNode,就得到了標準化的 container 與 offset 表示。

補充:輸入框的範圍讀取

規範規定輸入框的選擇區域與頁面選擇區域是相互分離的,因此輸入框有自己的一套獲取方式(IE 的寫法基本相同)。做富文本或者代碼編輯器一類的功能時,這部分需要單獨處理,不能與頁面 Range 混用。

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