DIV CSS 佈局教程網

在 iframe 編輯器的游標位置插入內容(相容 IE 與 Firefox)
編輯:關於JavaScript     

問題描述

用 iframe 做所見即所得編輯器時,一個常見需求是「在游標當前位置插入 HTML」,例如插入粗體文字、表情或圖片。難點在於 IE 與 Firefox 取得「游標所在範圍」的 API 完全不同。

範例代碼

<iframe id="x" name="x"></iframe>
<input type="button" onclick="t()" value="test">
<input type="button" onclick="frames['x'].location.href='about:blank';" value="clear">

<script>
function t(){
  window.frames["x"].document.designMode = "On";
  var html = '<b style="color:red">' + $('xx').value + '</b>';

  if (getBrowser() == 'ie') {
    var Editor = window.frames["x"];   // IE 必須用 frames 取,否則插入位置會跑到頁面頂端
    Editor.focus();
    var o = Editor.document.selection.createRange();
    o.pasteHTML(html);
  } else if (getBrowser() == 'chrome') {
    var Editor = $('x');               // 非 IE 要用元素節點
    Editor.focus();
    var rng = Editor.contentWindow.getSelection().getRangeAt(0);
    var frg = rng.createContextualFragment(html);
    rng.insertNode(frg);
  }
}

function getBrowser(){
  var agentValue = window.navigator.userAgent.toLowerCase();
  if (agentValue.indexOf('msie') > 0) return "ie";
  else if (agentValue.indexOf('firefox') > 0) return "ff";
  else if (agentValue.indexOf('chrome') > 0) return "chrome";
}

function $(id){ return document.getElementById(id); }
</script>
輸入:<input id="xx">

兩條技術路線的差異

IE 路線用的是已廢棄的 document.selection.createRange() 搭配 pasteHTML()。這裡有個關鍵細節:取得 iframe 的方式必須是 window.frames["x"],若直接用 getElementById 拿到元素再操作,插入的內容會跑到整個頁面最上方,而不是 iframe 內部游標處。

標準路線則是 window.getSelection().getRangeAt(0) 取得游標所在的 Range,再用 createContextualFragment() 把 HTML 字串解析成文件片段,最後 insertNode() 插入。這套 API 在 Firefox、Chrome、Edge 與 Safari 都通用。

實作上容易忽略的幾點

  • iframe 必須先設定 document.designMode = "On",否則它是唯讀的,游標根本不存在。
  • 插入前務必呼叫 focus(),否則 selection 可能為空。
  • 若 iframe 尚未載入完成就操作,getRangeAt(0) 會因為沒有範圍而丟出例外,實務上要加 try/catch 或等 onload。
  • designMode 這種自製編輯器在現代前端已少見,新專案建議直接採用 ContentEditable 或成熟編輯器(如 Quill、TinyMCE),省下大量跨瀏覽器處理。

另外,範例中的 getBrowser() 是靠 userAgent 字串比對,這是舊時代的做法。現在判斷 API 是否存在(特色偵測)才是正解,例如直接 if (window.getSelection) 決定走哪條路,不必先問「你是哪個瀏覽器」。

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