Range 物件代表頁面上的一段連續區域。透過它,開發者可以取得、修改、刪除或插入頁面中的內容。建立空 Range 的方式如下:
var range = document.createRange();
在 HTML5 中,每個瀏覽器視窗都有一個 Selection 物件,代表使用者目前以滑鼠選取的範圍。可用下列方式取得:
var selection = document.getSelection();
也可以寫成:
var selection = window.getSelection();
每個 Selection 物件可包含一個或多個 Range。Firefox 允許按住 Ctrl 選取多個連續區域,因此可能有多個 Range;其他瀏覽器通常只有一個。可透過 getRangeAt 取得指定索引的 Range:
var range = document.getSelection().getRangeAt(index);
rangeCount 可判斷目前是否有選取內容,以及選取了幾段。按下滑鼠時通常為 1,未選取時為 0,取消選取後可能仍有一個空 Range。
以下範例在點擊按鈕後,會列出目前選取了幾段內容,並逐段輸出文字。
function rangeTest() {
var showRangeDiv = document.getElementById("showRange");
var selection = document.getSelection();
if (selection.rangeCount > 0) {
var html = "你選取了 " + selection.rangeCount + " 段內容";
for (var i = selection.rangeCount; i > 0; i--) {
var range = selection.getRangeAt(i - 1);
html += "第 " + i + " 段內容為:" + range;
}
showRangeDiv.innerHTML = html;
}
}
在 Firefox 中可能看到多段選取結果:
在 Chrome 中通常只會有一段:
Range 物件提供多個屬性,可協助開發者判斷選取範圍的結構與位置:
selectNode 會把 Range 的起點與終點指定在某個節點的起點與終點,使範圍包含該節點。相對地,selectNodeContents 則是選取該節點內的所有內容。
deleteContents 會刪除 Range 所選取的內容。以下範例有兩個按鈕,一個只刪除元素內容,一個連元素一起刪除。
function deleteRangeContents(flag) {
var div = document.getElementById("div");
var rangeObj = document.createRange();
if (flag) {
rangeObj.selectNodeContents(div);
rangeObj.deleteContents();
} else {
rangeObj.selectNode(div);
rangeObj.deleteContents();
}
}
建立 Range 後,可先觀察物件狀態:
點擊刪除內容後,元素內容被清空:
此時 Range 的起點與終點會落在原內容位置:
若改為刪除元素,則整個元素會從 DOM 中移除:
刪除後 Range 會指向被移除的節點:
setStart 用於指定 Range 的起點,setEnd 則用於指定終點。若節點是文字節點,第二個參數代表字元位置;若節點包含子節點,則代表子節點的索引。例如可指定文字節點中第 3 個到第 10 個字元,再呼叫 deleteContents 刪除。
這四個方法可用來依據某個節點的前後位置設定 Range 的起點與終點。例如想刪除表格的第一行,可先取得該列節點,再將起點設在該列之前、終點設在該列之後,最後刪除內容。
cloneRange 會複製目前的 Range 物件,並回傳新的 Range。下圖為複製後的結果:
cloneContents 會把 Range 所選取的內容複製到 DocumentFragment 中。這個方法常用於複製元素內容,再附加到頁面其他位置。
extractContents 會把 Range 所選取的內容複製到 DocumentFragment,並從原頁面中刪除該內容。以下為移動前的畫面:
點擊移動後:
insertNode 會把指定節點插入到 Range 所代表範圍的起點位置。若該節點已存在於頁面中,則會被移動到該位置。以下為插入前的畫面:
插入後:
Range 是 HTML5 中處理頁面選取與內容操作的重要工具。無論是刪除文字、複製節點、移動內容,還是實作類似所見即所得編輯器的功能,都能透過 Range 完成。理解 Selection 與 Range 的關係,以及各方法之間的差異,是深入操作 DOM 的關鍵基礎。