DIV CSS 佈局教程網

JS 在光標所在位置插入 HTML 內容的方法
編輯:JavaScript基礎知識     

在可編輯區域(例如自製的留言框、富文本容器)中插入內容時,如果只是簡單地把字串塞進 innerHTML,使用者的游標位置就會被破壞,光標跳到開頭或結尾。要真正做到「在當前光標處插入」,必須操作 Selection 與 Range 這兩組 API。

一、核心思路

  1. 取得目前使用者的選取區(Selection)與其 Range 物件。
  2. 先刪除 Range 內被選中的內容。
  3. 把要插入的 HTML 字串轉成文件片段(DocumentFragment),再插入到 Range 的位置。
  4. 重新設定選取區,讓光標停在插入內容之後,維持連續輸入的體驗。

二、完整程式碼

function insertHtmlAtCaret(html) {
    var sel, range;
    if (window.getSelection) {
        // IE9 及其他標準瀏覽器
        sel = window.getSelection();
        if (sel.getRangeAt && sel.rangeCount) {
            range = sel.getRangeAt(0);
            range.deleteContents();

            // Range.createContextualFragment() 很方便,
            // 但它並非標準,部分瀏覽器(如 IE9)並不支援
            var el = document.createElement("div");
            el.innerHTML = html;

            var frag = document.createDocumentFragment(), node, lastNode;
            while ((node = el.firstChild)) {
                lastNode = frag.appendChild(node);
            }
            range.insertNode(frag);

            // 保留選取狀態,讓光標落在插入內容之後
            if (lastNode) {
                range = range.cloneRange();
                range.setStartAfter(lastNode);
                range.collapse(true);
                sel.removeAllRanges();
                sel.addRange(range);
            }
        }
    } else if (document.selection && document.selection.type != "Control") {
        // IE9 以下
        document.selection.createRange().pasteHTML(html);
    }
}

三、呼叫方式

var content = '你好啊,我是新插入的內容數據';
$('.js_content').focus();  // 要插入內容的 div,先讓它取得焦點
insertHtmlAtCaret(content);

四、幾個實作重點

  • 一定要先 focus。如果目標容器沒有焦點,window.getSelection() 拿到的可能是頁面其他位置的選取區,插入位置就會跑掉。
  • 用 DocumentFragment 而不是直接 insertNode(el)。文件片段是暫存容器,插入後會被清空,能把多次 DOM 操作合併成一次,效能更好,也不會留下多餘的父節點。
  • 插入後必須重設 Range。少了 setStartAfter 這段,插入完畢後光標位置會變得不可預期,使用者繼續打字時內容可能接在奇怪的地方。
  • 若需要兼容更老的 IE,document.selection.createRange().pasteHTML() 是唯一的路;現代專案則可以直接只保留標準分支。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved