大多數使用者只需要 innerText/innerHTML 與 outerText/outerHTML 這些屬性即可完成日常操作。然而,若要進行更進階的文字處理,例如搜尋與選取特定文字,就需要用到「文字範圍」(TextRange)物件。
TextRange 物件可以用來:
此功能在非 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 方法,但它不會保留文件的階層結構。
可用 execCommand 方法對文字套用格式或執行特殊動作。例如將文字變粗體:
var rng = document.body.createTextRange();
rng.collapse();
rng.expand("sentence");
rng.execCommand("Bold");
由於並非所有命令隨時可用,可用 queryCommandEnabled 與 queryCommandSupported 判斷可用性,用 queryCommandState 判斷命令是否已套用。
值得一提的是,由於物件模型不會持續持有文字範圍,一旦控制權離開又重回你的程式碼(例如事件處理函式返回後),就需要重新建立範圍。