做過聊天或留言功能的人大概都遇過這個需求:使用者把游標停在句子中間,點一下表情圖示,內容應該插在游標處,而不是被丟到整段文字的最後面。要做到這件事,就得讀取輸入框目前的游標位置,而這裡正好牽涉到舊 IE 與其他瀏覽器的差異。
(function($){
$.fn.extend({
insertAtCaret: function(myValue){
var $t=$(this)[0];
if (document.selection) {
this.focus();
sel = document.selection.createRange();
sel.text = myValue;
this.focus();
}
else
if ($t.selectionStart || $t.selectionStart == '0') {
var startPos = $t.selectionStart;
var endPos = $t.selectionEnd;
var scrollTop = $t.scrollTop;
$t.value = $t.value.substring(0, startPos) + myValue + $t.value.substring(endPos, $t.value.length);
this.focus();
$t.selectionStart = startPos + myValue.length;
$t.selectionEnd = startPos + myValue.length;
$t.scrollTop = scrollTop;
}
else {
this.value += myValue;
this.focus();
}
}
})
})(jQuery);
$("#textareaId").insertAtCaret("新表情");
這段程式看似複雜,其實是依瀏覽器能力分成三種情況。document.selection 存在代表是 IE 6~8,改用 createRange() 取得選取區並直接把文字寫進去;selectionStart 存在則是 IE9 以後與其他現代瀏覽器,用索引運算處理;兩者都沒有就退回最消極的做法——直接接在內容後面。
第二條分支裡有幾個細節值得說明。用 $t.selectionStart || $t.selectionStart == '0' 而非單純的 if ($t.selectionStart),是因為游標在最前面時值為 0,在布林脈絡下會被視為 false,必須額外比對才能通過。插入完成後把 selectionStart 與 selectionEnd 設成相同位置,等於把游標移到插入內容之後,使用者可以繼續打字。而 scrollTop 先存後還原,是因為改寫 value 會讓捲動位置跳回頂端,長篇內容編輯時體驗會很糟。
這份程式寫在 oninput 普及之前,若用於今日專案,其實可以簡化不少:現代瀏覽器一律支援 selectionStart,第一條 IE 分支可以整段移除;更乾淨的做法是搭配 setRangeText(),一行就能完成插入並自動處理游標位置。另外 sel 少了 var 宣告,會變成全域變數,這類疏漏在多分支程式裡特別容易發生,建議養成一律宣告的習慣。
最後,若插入的是 HTML 表情標籤而非純文字,要記得在後端做轉義或白名單處理,避免使用者輸入的內容被當成標籤執行。
以上就是這次的整理,希望對你的 jQuery 開發有所幫助。