DIV CSS 佈局教程網

一鍵複製文字到剪貼簿:跨瀏覽器相容的實作思路
編輯:JavaScript綜合知識     

「點一下就把信箱或邀請碼複製好」是個很實用的小功能,但瀏覽器對剪貼簿的開放程度差很多,早期只能靠 Flash 幫忙補洞。以下說明當時的相容策略,最後再談現在該怎麼寫。

當年的困境

  • IE 允許 JavaScript 直接存取剪貼簿:window.clipboardData。
  • 標準 DOM 瀏覽器基於安全考量不開放,於是社群做法是塞一個隱藏的 Flash(clipboard.swf)代為寫入。
  • 但 Flash Player 10 之後收緊了權限,非使用者手勢直接觸發的寫入會被拒絕。

相容版實作(歷史方案)

(function () {
  window['Util'] = {
    CACHE: {},

    getText: function () {
      return Util.CACHE.CLIPBOARD_TEXT;
    },

    successHide: function () {
      alert("複製成功!");
    },

    Copy: function (pStr, hasReturn, isdo) {
      var copy = document.getElementById('copy');

      if (window.clipboardData) {
        // IE:直接用內建 API
        copy.onclick = function () {
          window.clipboardData.setData("Text", pStr);
          Util.successHide();
        };
      } else {
        // 其他瀏覽器:動態插入 Flash object
        var html = [];
        html.push('<object type="application/x-shockwave-flash"'
                + ' data="clipboard.swf?gettext=Util.getText&success=Util.successHide"'
                + ' width="50" height="40"'
                + ' style="position:relative;top:11px;left:-50px;"'
                + ' id="ff_clipboard_swf">');
        html.push('<param name="quality" value="high" />');
        html.push('<param name="allowScriptAccess" value="sameDomain" />');
        html.push('<param name="allowFullScreen" value="true" />');
        html.push('<param name="wmode" value="transparent" />');
        html.push('</object>');

        var yu = copy.innerHTML;
        copy.innerHTML = yu + html.join('');
        Util.CACHE.CLIPBOARD_TEXT = pStr;
      }
    }
  };

  Util.Copy('zhaopin@beihai365.com');
})();

有個除錯小經驗值得記下:swf 的路徑一定要對。路徑錯的時候 Flash 不會報錯,只是懶懶地不出現手型游標——這是最容易誤判的特徵。

現在請改用 Clipboard API

Flash 早已停止支援,上面這套只能當歷史參考。今天寫剪貼簿,用標準 API 就好:

async function copyText(text) {
  try {
    await navigator.clipboard.writeText(text);
    alert("已複製:" + text);
  } catch (err) {
    // 非 HTTPS 或舊瀏覽器會走到這裡
    fallbackCopy(text);
  }
}

function fallbackCopy(text) {
  var ta = document.createElement('textarea');
  ta.value = text;
  ta.style.position = 'fixed';
  ta.style.opacity = '0';
  document.body.appendChild(ta);
  ta.select();
  document.execCommand('copy');   // 已標記為不建議,但仍是舊瀏覽器唯一解
  document.body.removeChild(ta);
}

兩個重點:一、navigator.clipboard 需要安全環境(HTTPS 或 localhost),http 網站會拿到 undefined;二、寫入剪貼簿必須在使用者手勢(點擊、按鍵)的呼叫鏈內,在 setTimeout 或 Ajax 回呼裡呼叫會被瀏覽器拒絕——這一點和當年 Flash 的限制其實如出一轍。

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