DIV CSS 佈局教程網

JavaScript DOM 學習(第九章):選取範圍(Range)介紹
編輯:JavaScript基礎知識     

雖然我們也會講解如何用程式建立範圍物件,但重點會放在如何將使用者的選取範圍轉換為 W3C 範圍或微軟的文件範圍物件。

什麼是範圍

範圍是指 HTML 文件中任意一部分的內容。一個範圍的開始和結束點都可以是任意的,甚至相同(一個空範圍)。最常見的範圍就是使用者選取的文字——當使用者在頁面上選取了一部分,你就可以把他的選取部分轉換為範圍物件;當然,你也可以讓程式自動選擇範圍。

以以下程式碼為例,假設使用者選擇了其中一段文字:

<h4 id="entry1196"><a
 href="https://radar.oreilly.com/archives/2007/03/call_for_a_blog_1.html"
 class="external">Call for a Blogger's Code of Conduct</a></h4>

<p>Tim O'Reilly calls for a Blogger Code of Conduct. His proposals are:</p>

<ol>
 <li>Take responsibility not just for your own words, but for the
 comments you allow on your blog.</li>
 <li>Label your tolerance level for abusive comments.</li>
 <li>Consider eliminating anonymous comments.</li>
</ol>

你可以將使用者選擇轉換為一個包含所選範圍文字的範圍物件。根據範圍物件,你能找到開始與結束的範圍點,進而刪除、複製,或用其他文字甚至 HTML 代碼替代它。

上面是最簡單的例子,因為它只包含文字。下面來看一個複雜的例子:使用者的選擇範圍跨越了幾個元素,去掉其他內容後剩下:

calls for a Blogger Code of Conduct. His proposals are:</p>

<ol>
 <li>Take responsibility not just for your own words, but for the
 comments you allow on your blog.</li>
 <li>Label your toleran

這是一段不完整的 HTML。幸好所有瀏覽器都會自動補全:

<p>calls for a Blogger Code of Conduct. His proposals are:</p>

<ol>
 <li>Take responsibility not just for your own words, but for the
 comments you allow on your blog.</li>
 <li>Label your toleran</li></ol>

正如你所見,瀏覽器會添加最少的元素讓這段 HTML 完整,若你複製它,這些添加的東西也會被複製。

瀏覽器相容性一覽

主要問題在於這裡有不下 3 種範圍物件類型,你必須有所了解:

Explorer 6/7:W3C Range 不支援;Microsoft Text Range 支援。
Firefox 2:W3C Range 支援;Mozilla Selection 支援。
Safari 1.3:W3C Range 支援;Mozilla Selection 不完整。
Opera 9:W3C Range 支援;Mozilla Selection 支援;Microsoft Text Range 不完整。

存取使用者選區

要處理使用者的選擇,就必須先存取到選區。這裡會立刻出現一個程式碼分支:IE 使用微軟的方法,其他瀏覽器使用 Mozilla 的方法:

var userSelection;
if (window.getSelection) {
    userSelection = window.getSelection();
}
else if (document.selection) { // should come last; Opera!
    userSelection = document.selection.createRange();
}

在 Mozilla、Safari、Opera 中,現在 userSelection 是一個選擇物件(selection object);在 IE 中則是一個文字範圍物件(text range object)。這個區別在後續程式碼中依然有效:IE 的文字範圍物件與 W3C 範圍物件、Mozilla 選擇物件有根本不同。

要注意分支順序:Mozilla Selection 一定要在前。因為 Opera 兩種都支援,若用 window.getSelection() 讀取選區,Opera 會建立選擇物件;用 document.selection 時它也會建立文字範圍物件。因此必须把 window.getSelection 放在前面檢測。

userSelection 的內容

現在 userSelection 既是 Mozilla 選擇物件又是 IE 文字範圍物件。在 Mozilla 選擇物件中保存的是使用者選擇的文字(而非 HTML):

alert(userSelection)

若想微軟文字範圍物件取得相同內容,可使用:

var selectedText = userSelection;
if (userSelection.text) selectedText = userSelection.text;

現在 selectedText 就包含了使用者選擇的文字。若你覺得這樣的資訊已足夠,就可以開始後續工作了。

從選擇物件建立範圍物件

很多時候你想處理的是代表使用者選擇範圍的範圍物件。在微軟模式中 userSelection 已是文字範圍;在 W3C 相容瀏覽器中它仍只是選擇物件,此時就要建立一個內容相同的範圍物件:

var rangeObject = getRangeObject(userSelection);
function getRangeObject(selectionObject) {
    if (selectionObject.getRangeAt)
        return selectionObject.getRangeAt(0);
    else { // Safari!
        var range = document.createRange();
        range.setStart(selectionObject.anchorNode, selectionObject.anchorOffset);
        range.setEnd(selectionObject.focusNode, selectionObject.focusOffset);
        return range;
    }
}

理想情況下,我們透過選擇物件的 getRangeAt() 存取 W3C 範圍物件。這個方法會在給定位置回傳一個範圍物件(第一個範圍物件編號為 0),並已設計好處理多處選擇的情況。

自行建立一個範圍

不幸的是 Safari 1.3 不支援 getRangeAt(),因此我們需要建立一個與使用者選擇相同的範圍物件。首先建立一個空物件:

var range = document.createRange();

為了把它插入到文件中,需要使用 setStart() 與 setEnd() 函數。這兩個方法需要兩個參數:在哪個 DOM 節點上開始或結束?從哪個文字偏移上開始或結束?(文字偏移指範圍物件第一個或最後一個字元的位置。)

再看一次前面跨越多元素的例子:範圍從 <p> 節點開始,文字偏移量是 13(因為第 14 個字元已包含在範圍內,編號從 0 起算);範圍從 <li> 結束,偏移量是 17。

var startPar = [the p node];
var endLi = [the second li node];
range.setStart(startPar, 13);
range.setEnd(endLi, 17);

(注意此時建立的範圍對使用者不可見,只在瀏覽器內部。)現在範圍已建立,我們也能讀出它的開始和結束點:startContainer 和 startOffset 決定開始位置,endContainer 和 endOffset 決定結束位置。

讀取選區的開始和結束位置

由於你並不知道使用者選擇了頁面哪個部分,所以需先讀出選擇的開始與結束位置——這必須在選擇物件中完成,因為此時還沒有範圍物件。選擇物件也有相似的屬性,只是名稱不同:anchorNode/anchorOffset 代表開始位置,focusNode/focusOffset 代表結束位置。

range.setStart(selectionObject.anchorNode, selectionObject.anchorOffset);
range.setEnd(selectionObject.focusNode, selectionObject.focusOffset);

如此一來,我們便同時擁有了範圍物件與微軟文字範圍物件,後續再講解如何使用它們並解決相容問題。

原文翻譯自 quirksmode.org,作者:北玉(@rehawk)。

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