DIV CSS 佈局教程網

在光標位置插入文字:同時相容 IE 與 Firefox 的實作
編輯:關於JavaScript     

要在輸入框游標所在處插入字串,IE 與 Firefox 用的是兩套完全不同的 API。以下這個函數把兩邊都包好了,還兼顧捲動位置的保留。

程式碼

// 在光標處插入字串
// myField : 文本框物件
// myValue : 要插入的值
function insertAtCursor(myField, myValue)
{
    // IE 使用 document.selection
    if (document.selection)
    {
        myField.focus();
        sel = document.selection.createRange();
        sel.text = myValue;
        sel.select();
    }
    // Mozilla / Netscape 使用 selectionStart / selectionEnd
    else if (myField.selectionStart || myField.selectionStart == '0')
    {
        var startPos = myField.selectionStart;
        var endPos = myField.selectionEnd;

        var restoreTop = myField.scrollTop;   // 先存下捲動位置
        myField.value = myField.value.substring(0, startPos)
                      + myValue
                      + myField.value.substring(endPos, myField.value.length);
        if (restoreTop > 0) myField.scrollTop = restoreTop;   // 再還原

        myField.focus();
        myField.selectionStart = startPos + myValue.length;
        myField.selectionEnd = startPos + myValue.length;
    }
    else
    {
        myField.value += myValue;
        myField.focus();
    }
}

三個分支各自的用意

IE 分支:透過 document.selection.createRange() 取得文字區段物件,把 text 設為要插入的內容即可。這個 API 在現代 IE 標準模式下已改用下一種寫法,此分支主要為相容舊版。

標準分支:讀取 selectionStart 與 selectionEnd 取得選取範圍,用三:nth段 substring 重組字串——前段加插入內容加後段。注意這裡用的是 endPos 而非 startPos 作為後段起點,因此若使用者原本選中了文字,該段會被替換掉,符合一般編輯器的行為。

降級分支:兩個 API 都不可用時,直接附加到尾端。功能退化了,但至少不會出錯。

幾個細節值得注意

捲動位置的保存:直接改寫 value 會讓長文字框的捲動位置跳回頂端。先把 scrollTop 存起來、寫入後再還原,是個容易忽略卻很影響體驗的細節。

插入後把游標移到插入內容之後:把 selectionStart 與 selectionEnd 設為相同值,等同於「取消選取並定位游標」,讓使用者能繼續輸入。

那個 == '0' 的判斷:selectionStart 為 0 時在布林脈絡下是 false,因此必須額外判斷,否則游標在第一個字元前的情況會落入降級分支。

示範

<form>
<textarea id="demo" style="width:500px; height:300px">
將鼠標定位到這裡的任意位置,然後點擊下面的按鈕,即可測試效果
</textarea>
<input type="button" onclick="insertAtCursor(document.getElementById('demo'), '【】')" value="插入符號" id="Button1">
<input type="button" onclick="insertAtCursor(document.getElementById('demo'), 'jb51.net')" value="jb51.net" id="Button2">
</form>

今天的專案已很少需要手寫這段邏輯——setRangeText() 與 Selection API 都能更簡潔地完成同樣的事。但理解底層的三段字串重組原理,在處理語法高亮編輯器、標記插入這類進階需求時仍然用得上。

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