要在輸入框游標所在處插入字串,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 都能更簡潔地完成同樣的事。但理解底層的三段字串重組原理,在處理語法高亮編輯器、標記插入這類進階需求時仍然用得上。