DIV CSS 佈局教程網

JavaScript 操作 Selection 物件:替換使用者選取的文字
編輯:關於JavaScript     

要動態替換使用者當前選取的文字,需要透過 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 風險。

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