二級 DOM 定義了一個 createRange() 方法(IE 並未支援此標準,但其自有屬性與方法反而更豐富)。由於它屬於 document 物件,因此建立一個 range 物件要這樣做:
var oRange = document.createRange();
若要檢測瀏覽器是否支援標準的 Range 物件,可用 hasFeature() 方法:
var supportsDOMRanges = document.implementation.hasFeature("Range", "2.0");
if (supportsDOMRange) {
var oRange = document.createRange();
// range 相關程式碼
}
最簡單的選擇方式是 selectNode() 或 selectNodeContents(),兩者都只接受一個 DOM 節點參數。差別在於:selectNode() 會選擇整個節點(含其子節點),而 selectNodeContents() 只選擇該節點的「內容」。
以 <p id="p1"><b>Hello</b> World</p> 為例:
var oRange1 = document.createRange();
var oRange2 = document.createRange();
var oP1 = document.getElementById("p1");
oRange1.selectNode(oP1);
oRange2.selectNodeContents(oP1);
下圖清楚說明了兩者的差異。
建立 Range 物件後,它會有以下屬性:
註:這些屬性均為唯讀(read-only)。
以下程式展示這些屬性,請在支援此標準的瀏覽器(如 Mozilla Firefox,對應 DOM 二級)中執行,IE 中將無效:
<script type="text/javascript">
function useRanges() {
var oRange1 = document.createRange();
var oRange2 = document.createRange();
var oP1 = document.getElementById("p1");
oRange1.selectNode(oP1);
oRange2.selectNodeContents(oP1);
document.getElementById("txtStartContainer1").value = oRange1.startContainer.tagName;
document.getElementById("txtStartOffset1").value = oRange1.startOffset;
document.getElementById("txtEndContainer1").value = oRange1.endContainer.tagName;
document.getElementById("txtEndOffset1").value = oRange1.endOffset;
document.getElementById("txtCommonAncestor1").value = oRange1.commonAncestorContainer.tagName;
// oRange2 亦以相同方式讀取
}
</script>
Range 還提供了設定起訖位置的方法:
setStartBefore(node) — 將 Range 的起始設在 node 之前。setStartAfter(node) — 將 Range 的起始設在 node 之後。setEndBefore(node) — 將 Range 的結束設在 node 之前。setEndAfter(node) — 將 Range 的結束設在 node 之後。以上是 Range 操作的基礎,後續頁面將繼續介紹更多進階用法。(目前為 1/3 頁)