DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 Range 物件詳解:選取、刪除、複製與插入的實務應用
編輯:HTML5詳解     

一、Range 物件的概念

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

Range 物件提供多個屬性,可協助開發者判斷選取範圍的結構與位置:

  • collapsed:判斷起點與終點是否在同一位置。
  • commonAncestorContainer:取得包含整個範圍的最低層節點。
  • startContainer:取得範圍起點所在的最底層節點。
  • startOffset:取得起點與所屬節點起點之間的距離。
  • endContainer:取得範圍終點所在的最底層節點。
  • endOffset:取得終點與所屬節點起點之間的距離。

三、常用方法

selectNode 與 selectNodeContents

selectNode 會把 Range 的起點與終點指定在某個節點的起點與終點,使範圍包含該節點。相對地,selectNodeContents 則是選取該節點內的所有內容。

deleteContents

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 與 setEnd

setStart 用於指定 Range 的起點,setEnd 則用於指定終點。若節點是文字節點,第二個參數代表字元位置;若節點包含子節點,則代表子節點的索引。例如可指定文字節點中第 3 個到第 10 個字元,再呼叫 deleteContents 刪除。

setStartBefore、setStartAfter、setEndBefore、setEndAfter

這四個方法可用來依據某個節點的前後位置設定 Range 的起點與終點。例如想刪除表格的第一行,可先取得該列節點,再將起點設在該列之前、終點設在該列之後,最後刪除內容。

cloneRange

cloneRange 會複製目前的 Range 物件,並回傳新的 Range。下圖為複製後的結果:

cloneContents

cloneContents 會把 Range 所選取的內容複製到 DocumentFragment 中。這個方法常用於複製元素內容,再附加到頁面其他位置。

extractContents

extractContents 會把 Range 所選取的內容複製到 DocumentFragment,並從原頁面中刪除該內容。以下為移動前的畫面:

點擊移動後:

insertNode

insertNode 會把指定節點插入到 Range 所代表範圍的起點位置。若該節點已存在於頁面中,則會被移動到該位置。以下為插入前的畫面:

插入後:

結語

Range 是 HTML5 中處理頁面選取與內容操作的重要工具。無論是刪除文字、複製節點、移動內容,還是實作類似所見即所得編輯器的功能,都能透過 Range 完成。理解 Selection 與 Range 的關係,以及各方法之間的差異,是深入操作 DOM 的關鍵基礎。

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