最近項目有一個需求:在富文本編輯器(KindEditor)中加入類似 QQ 群「@某人」的功能,能夠便捷地提示並插入用戶名。網上找到的 bootstrap-suggest 插件無法完全滿足需求,於是在其基礎上進行改良,實現了一款名為 jquery-kindeditor-suggest 的插件。
相比原插件,主要做了三點改進:

最初使用的 bootstrap-suggest 能實現基本的下拉提示,但存在幾個問題:只能單一匹配、偶數位的 @ 功能會失效、選取值後只是簡單插入文本而非成塊效果。
1. 修正 startOffset 取值出錯問題
若使用 KindEditor 的 insertHTML,會導致下一次 startOffset 取值出錯。原插件在獲取光標位置時會插入一個臨時 span,用完後刪除,但這會干擾下一次 editor.cmd.range.startOffset。於是改用文檔碎片的方式插入:
var doc = editor.cmd.range.doc, range = editor.cmd.range, frag = doc.createDocumentFragment();
KindEditor('@<span id="input-textarea-caret-position-mirror-span">.</span>', doc).each(function () {
frag.appendChild(this);
});
range.deleteContents();
range.insertNode(frag);
range.collapse(false);
2. 替換選擇值並保證光標位置正確
把 @ 後面已輸入的內容(含 @)刪除,然後插入一個完整的標簽作為「成塊」內容,同時確保光標定位正確:
var dType = !!el.cmd.range.startContainer.data ? "data" : "innerHTML";
var sVal = el.cmd.range.startContainer[dType];
var lAt = sVal.lastIndexOf(this.key);
el.cmd.range.startContainer[dType] = sVal.substring(0, lAt);
el.insertHtml("<span contenteditable='false'>" + this.key + item.value + ' </span>' +
'<span id="input-textarea-caret-position-mirror-span">.</span>');
var span = el.edit.doc.getElementById('input-textarea-caret-position-mirror-span');
var range = el.edit.doc.createRange();
range.selectNodeContents(span);
range.collapse(false);
var sel = el.edit.win.getSelection();
sel.removeAllRanges();
sel.addRange(range);
// hack:修正下一次 startOffset
span.parentNode.removeChild(span);
插入的內容以「成塊」形式呈現在富文本區域中,既方便刪除,也與周圍文本清晰區分。

雖然是在他人插件基礎上改進,但修復這些問題也花費了不少心思。由於此前一直沒有找到精準針對 KindEditor @ 功能的插件,索性自己動手完善。源碼已放在 GitHub:https://github.com/codingforme/jquery-kindeditor-suggest ,有需要的朋友可以下載參考。