TextRange 對象是動態 HTML(DHTML)的高級特性,能實現許多與文本相關的任務,比如搜索和選擇文本。它是在文檔文本流上建立開始與結束位置的抽象對象。本文對它的常用屬性與方法做個小結。
屬性:boundingHeight(矩形高度)、boundingLeft(左側距離)、offsetLeft/offsetTop(計算坐標)、htmlText(矩形寬度)、text(設置或獲取文本)。
方法:moveStart(改開始位置)、moveEnd(改結束位置)、collapse(重疊為插入點)、move(折疊並移動)、execCommand(執行命令)、select(選中當前范圍)、findText(搜索文本)。
使用 TextRange 通常包括三步:1. 創建文本范圍;2. 設置開始點和結束點;3. 對范圍進行操作。
這裡先用 createTextRange() 創建范圍(BODY、TEXT、TextArea、BUTTON 等元素都支持),再用 move("character", count) 移動插入點,最後用 select() 顯示光標——所謂「光標」其實就是邊界重合的范圍。
findText() 是 TextRange 最有用的方法之一,默認從開始點到結束點搜索一個不區分大小寫的字符串,找到就把范圍設為该文本並返回 true:
由於搜索從當前開始點進行,再次查詢前需把開始點移到上次匹配的末尾,這裡用 collapse(false) 把范圍重疊到結束點即可實現連續查找。
moveStart() 與 moveEnd() 類似 move,默認開始點為第一個字符、結束點為最後一個字符,可透過參數向前後移動任意字符數。collapse() 可把范圍重疊成單個插入點,默認在開始點重合。findText() 的 searchScope 控制搜索范圍、flags 控制是否區分大小寫與全詞匹配(值為 2 全詞、4 大小寫、6 兩者兼具)。parentElement() 則返回包含文本范圍的容器元素,可用來獲取選中文本所屬的 DOM 對象。
掌握這些屬性與方法,就能靈活實現文本選擇、查找替換與光標定位等豐富交互。