DIV CSS 佈局教程網

標準 DOM Range 操作全集(第 1/3 頁)
編輯:JavaScript基礎知識     

二級 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 相關程式碼
}

用 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 物件的屬性

建立 Range 物件後,它會有以下屬性:

  • startContainer — 回傳 range 起始所在的節點(父節點的第一個節點)。
  • startOffset — 回傳 range 起始的偏移量。若 startContainer 是文字、註解或 CDATA 節點,則回傳文字偏移量,否則回傳第一個節點的索引。
  • endContainer — 回傳 range 結束所在的節點(父節點的最後一個節點)。
  • endOffset — 回傳 range 結束的偏移量,特性與 startOffset 相同。
  • commonAncestorContainer — 回傳第一個包含該 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 的其他方法

Range 還提供了設定起訖位置的方法:

  • setStartBefore(node) — 將 Range 的起始設在 node 之前。
  • setStartAfter(node) — 將 Range 的起始設在 node 之後。
  • setEndBefore(node) — 將 Range 的結束設在 node 之前。
  • setEndAfter(node) — 將 Range 的結束設在 node 之後。

以上是 Range 操作的基礎,後續頁面將繼續介紹更多進階用法。(目前為 1/3 頁)

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