DIV CSS 佈局教程網

深入使用 TextRange 文字範圍物件
編輯:JavaScript基礎知識     

大多數使用者只需要 innerText/innerHTML 與 outerText/outerHTML 這些屬性即可完成日常操作。然而,若要進行更進階的文字處理,例如搜尋與選取特定文字,就需要用到「文字範圍」(TextRange)物件。

TextRange 能做什麼

TextRange 物件可以用來:

  • 定位特定元素或特定點上的文字
  • 在文件文字中搜尋單字與字元
  • 以邏輯單位(單字、句子)移動
  • 對純文字與 HTMLText 提供讀寫存取

此功能在非 Microsoft Win32 平台上可能無法使用。

什麼是文字範圍

TextRange 是一個抽象物件,它在 HTML 文件所呈現的文字流上,建立了一個「起點」與「終點」。以這段文件為例:

<HTML>
<BODY>
  <H1>Welcome</H1>
  <CENTER><H2>Overview</H2></CENTER>
  <P>Be sure to <B>Refresh</B> this page.</P>
</BODY>
</HTML>

若對 body 元素建立文字範圍,起點會落在 body 文字內容的開頭,終點落在結尾,範圍內的純文字即為「Welcome Overview Be sure to Refresh this page.」。

定位文字範圍

每個文字範圍都有起點與終點。建立新範圍時,起終點預設涵蓋整個內容。可用 move、moveStart、moveEnd 等方法改變範圍,或用 moveToElementText 定位到特定元素、moveToPoint 定位到使用者點擊的座標:

function selectMe() {
  var r = document.body.createTextRange();
  r.moveToPoint(window.event.x, window.event.y);
  r.expand("word");
  r.select();
}

取得範圍內容

用 text 屬性可讀寫範圍內的純文字(類似 innerText,但作用於範圍);htmlText 屬性則唯讀,可檢視範圍內的 HTML。若要加入 HTML 內容,可使用 pasteHTML 方法,但它不會保留文件的階層結構。

比較與儲存範圍

  • duplicate:複製一個範圍,方便臨時存取。
  • inRange:判斷某範圍是否完全包含於另一範圍內。
  • isEqual:判斷兩個範圍的起終點是否完全相同。
  • setEndPoint:將某範圍的起或終點對齊到另一範圍。
  • compareEndPoints:比較兩範圍端點,回傳 -1、0 或 1。
  • getBookmark/moveToBookmark:用書籤儲存並還原起終點位置。

套用命令

可用 execCommand 方法對文字套用格式或執行特殊動作。例如將文字變粗體:

var rng = document.body.createTextRange();
rng.collapse();
rng.expand("sentence");
rng.execCommand("Bold");

由於並非所有命令隨時可用,可用 queryCommandEnabled 與 queryCommandSupported 判斷可用性,用 queryCommandState 判斷命令是否已套用。

值得一提的是,由於物件模型不會持續持有文字範圍,一旦控制權離開又重回你的程式碼(例如事件處理函式返回後),就需要重新建立範圍。

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