DIV CSS 佈局教程網

JavaScript 複製文字到剪貼簿:多瀏覽器分支處理的實作
編輯:JavaScript綜合知識     

點一下按鈕,把文字寫進剪貼簿。這個功能在瀏覽器支援度參差的年代需要三條分支:IE 走內建 API、Opera 走 location 變通、Mozilla 走 XPCOM 元件。以下保留這個經典寫法作為理解,最後再給現代版本。

經典相容實作

<script type="text/javascript" language="javascript">
// 複製到剪貼簿
function copyToClipBoard(s) {
  if (window.clipboardData) {
    // IE:直接呼叫內建剪貼簿物件
    window.clipboardData.setData("Text", s);
    alert("已經複製到剪貼簿!\n" + s);

  } else if (navigator.userAgent.indexOf("Opera") != -1) {
    // 舊 Opera:用 location 跳轉變相處理
    window.location = s;

  } else if (window.netscape) {
    // Firefox 舊版:透過 XPCOM 元件操作
    try {
      netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
    } catch (e) {
      alert("被瀏覽器拒絕!\n請在瀏覽器地址欄輸入 'about:config' 並回車,"
          + "然後將 'signed.applets.codebase_principal_support' 設置為 'true'");
    }

    var clip = Components.classes['@mozilla.org/widget/clipboard;1']
               .createInstance(Components.interfaces.nsIClipboard);
    if (!clip) return;

    var trans = Components.classes['@mozilla.org/widget/transferable;1']
                .createInstance(Components.interfaces.nsITransferable);
    if (!trans) return;

    trans.addDataFlavor('text/unicode');

    var str = Components.classes["@mozilla.org/supports-string;1"]
              .createInstance(Components.interfaces.nsISupportsString);
    var copytext = s;
    str.data = copytext;
    trans.setTransferData("text/unicode", str, copytext.length * 2);

    var clipid = Components.interfaces.nsIClipboard;
    if (!clip) return false;

    clip.setData(trans, null, clipid.kGlobalClipboard);
    alert("已經複製到剪貼簿!\n" + s);
  }
}
</script>

三條分支的思路各自不同:IE 是唯一「 freely 開放」的;Opera 那條其實沒有真的複製,只是把內容當網址跳轉,是個權宜之計;Firefox 的 XPCOM 寫法則要求使用者手動改 about:config 設定,實務上幾乎不可能推廣。

現在請這樣寫

上面那段程式碼今天已無實用價值——Components 與 XPCOM 在 Firefox 早已移除,window.clipboardData 也不再可靠。標準做法是 Clipboard API:

async function copyToClipBoard(text) {
  try {
    await navigator.clipboard.writeText(text);
    alert("已經複製到剪貼簿!\n" + text);
  } catch (err) {
    // 非安全環境(http)或舊瀏覽器,退回 execCommand
    var ta = document.createElement('textarea');
    ta.value = text;
    ta.setAttribute('readonly', '');
    ta.style.position = 'fixed';
    ta.style.left = '-9999px';
    document.body.appendChild(ta);
    ta.select();

    var ok = document.execCommand('copy');
    document.body.removeChild(ta);

    alert(ok ? "已經複製到剪貼簿!\n" + text : "複製失敗,請手動選取文字");
  }
}

// 綁到按鈕上
document.getElementById('copyBtn')
        .addEventListener('click', function () {
          copyToClipBoard('zhaopin@example.com');
        });

三個必知限制:一、navigator.clipboard 只在 HTTPS 或 localhost 可用;二、寫入必須在使用者手勢的呼叫鏈內,包在 setTimeout 或 Ajax 回呼裡會被拒;三、Firefox 上的降級方案需要 ta.select() 而非 focus,少了 select 會複製失敗。另外,把隱藏用的 textarea 設為 position:fixed 加移出視窗,是為了避免 iOS Safari 在 append 時自動捲動頁面。

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