萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

跨瀏覽器「單擊複製文字」完美方案:Clipboard API 降級至 Flash 相容全攻略

演進歷程與現狀

  • IE 專有:window.clipboardData.setData('Text', str) 簡單直接。
  • 標準瀏覽器(Chrome/Firefox/Safari/Edge):長期禁止 JS 直接存取剪貼板,早期方案需借助 Flash (clipboard.swf) 橋接。
  • 現代標準:navigator.clipboard.writeText(str)(Clipboard API)已獲主流瀏覽器支援,**僅限 HTTPS 或 localhost**,且需在用戶手勢(click)中呼叫。

統一封裝:特性偵測 + 降級策略

var ClipboardUtil = (function() {
  var cache = {};

  function showSuccess() { alert('複製成功!'); }

  function copyWithFlash(text) {
    var html = [
      '<object type="application/x-shockwave-flash" ',
      'data="clipboard.swf?gettext=ClipboardUtil.getText&success=ClipboardUtil.successHide" ',
      'width="50" height="40" style="position:relative;top:11px;left:-50px;" ',
      'id="ff_clipboard_swf">',
      '<param name="quality" value="high" />',
      '<param name="allowScriptAccess" value="sameDomain" />',
      '<param name="allowFullScreen" value="true" />',
      '<param name="wmode" value="transparent" />',
      '</object>'
    ].join('');
    var container = document.getElementById('copy');
    container.innerHTML = container.innerHTML + html;
    cache.CLIPBOARD_TEXT = text;
  }

  return {
    getText: function() { return cache.CLIPBOARD_TEXT; },
    successHide: showSuccess,
    copy: function(text) {
      if (navigator.clipboard && window.isSecureContext) {
        // 現代 Clipboard API(最優先)
        navigator.clipboard.writeText(text).then(showSuccess).catch(function() {
          fallback(text);
        });
      } else if (window.clipboardData) {
        // IE 降級
        window.clipboardData.setData('Text', text);
        showSuccess();
      } else {
        // Flash 降級(舊版瀏覽器)
        fallback(text);
      }
      function fallback(t) { copyWithFlash(t); }
    }
  };
})();

// 使用:綁定按鈕點擊
document.getElementById('btnCopy').addEventListener('click', function() {
  ClipboardUtil.copy('zhaopin@beihai365.com');
});

關鍵實作細節

  1. Flash SWF 路徑必須正確:否則不會出現手型游標,複製靜默失敗。
  2. 容器元素需可見:Flash 物件需依附於 DOM 節點,display:none 會導致失效。
  3. 安全上下文判斷:window.isSecureContext 確認 HTTPS/localhost,否則 Clipboard API 會拋 DOMException。
  4. 用戶手勢必要:所有複製操作必須在 click、keydown 等可信事件內觸發。

現代專案建議

**直接使用 Clipboard API**,僅在極舊環境(IE11、舊版移動瀏覽器)才考慮降級。可引入 clipboard-polyfill 統一介面:

import clipboard from 'clipboard-polyfill';
btn.addEventListener('click', () => clipboard.writeText('文字').then(...));
copyright © 萬盛學電腦網 all rights reserved