要動態替換使用者當前選取的文字,需要透過 Selection 與 Range 這組 API。以下範例同時處理了非 IE 與舊版 IE 兩種寫法,可以清楚看出兩邊的差異。
//替換選中文本內容,參數text為要替換的內容
function SetSelectionText(text) {
//非IE浏覽器
if (window.getSelection) {
var sel = window.getSelection();
alert(sel.rangeCount); //選區個數, 通常為 1
sel.deleteFromDocument(); //清除選擇的內容
var r = sel.getRangeAt(0); //即使已經執行了deleteFromDocument(), 這個函數仍然返回一個有效對象
var selFrag = r.cloneContents(); //克隆選擇的內容
var frag = selFrag.childNodes;
//如果執行了deleteFromDocument(), 這個數組長度將會是 0
for (var i = 0; i < frag.length; i++) {
alert(frag[i].nodeName); //枚舉選擇的對象
}
var h1 = document.createElement('H1'); //生成一個插入對象
h1.innerHTML = text; //設置這個對象的內容
r.insertNode(h1); //把對象插入到選區
//insertNode 不會替換選擇的內容,而是追加到選區後面,
//所以需要普通粘貼的替換效果,之前要執行 deleteFromDocument()
} else if (document.selection && document.selection.createRange) {
//IE浏覽器
var sel = document.selection.createRange(); //獲得選區對象
alert(sel.htmlText); //選擇區的html文本
sel.pasteHTML('<h1>標題</h1>'); //粘貼到選區的html內容, 會替換選擇的內容
}
}
幾點實作上的提醒。
rangeCount 表示目前選區中有幾個 Range,一般情形下是 1,但跨元素多段選取時可能大於 1,取值前最好先確認。
insertNode 是「插入」而非「取代」,這也是為什麼範例要先呼叫 deleteFromDocument() 才能得到一般貼上那樣的替換效果。
deleteFromDocument() 之後 Range 物件仍然有效,getRangeAt(0) 拿到的仍是同一個 Range,這點在範例中以註解標明。
最後要留意的是,document.selection 與 pasteHTML 屬於舊版 IE 的專屬 API,在現代瀏覽器中並不存在。今日的專案可以直接使用 Selection/Range 標準寫法;如果確實需要相容舊系統,建議把兩條分支清楚隔離,並在維護時標註哪一段僅供 legacy 使用。此外,pasteHTML 直接插入 HTML 字串時若摻入使用者輸入的內容,務必先做轉義,避免 XSS 風險。