萬盛學電腦網

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

JavaScript 複製到剪貼簿:跨瀏覽器相容性實測與 Zero Clipboard / zclip 方案全解析

前言:為什麼複製功能這麼難?

瀏覽器基於安全考量,長期限制 JavaScript 直接存取系統剪貼簿。各大瀏覽器支援度不一,導致開發者必須採用不同策略甚至引入 Flash 方案。本文整理實測結果與主流解決方案。

各瀏覽器原生支援現況(歷史回顧)

瀏覽器支援方式備註
IEwindow.clipboardData.setData()
document.execCommand('Copy')
TextRange.execCommand('Copy')
多種專有 API,相容性最好
Firefox (≤17)Components.classes['@mozilla.org/widget/clipboard;1']17 版後因安全性移除介面
Chrome / 新版 Firefox / Edge無原生 JS API 開放需透過 Flash 或使用者互動觸發

方案一:Zero Clipboard(Flash 方案,已淘汰)

運作原理

利用透明的 Flash 物件覆蓋在按鈕上方,使用者點擊按鈕實際觸發 Flash,再由 Flash 呼叫 System.setClipboard() 寫入剪貼簿。

使用步驟

  1. 下載 ZeroClipboard.js 與 ZeroClipboard.swf 放入專案同目錄
  2. 引入 JS:<script src="ZeroClipboard.js"></script>
  3. 初始化:
    var clip = new ZeroClipboard.Client();
    clip.setHandCursor(true);
    clip.setText("要複製的文字");
    clip.glue("copy-button-id"); // 綁定按鈕

常見坑點

  • 必須在 HTTP 伺服器環境下運行(Apache/Tomcat/IIS),本地 file:// 協定 Flash 會被阻擋
  • Flash 遮蓋導致按鈕 :hover 樣式失效,需呼叫 setCSSEffects() 修正
  • Flash 已於 2020 年底停止支援,新專案勿採用

方案二:jquery.zclip(Zero Clipboard 的 jQuery 封裝)

語法更簡潔,適合已引入 jQuery 的舊專案維護:

$("#copy-btn").zclip({
    path: "ZeroClipboard.swf",
    copy: function(){ return $("#text-input").val(); },
    afterCopy: function(){ alert("複製成功"); }
});

現代標準解法:Clipboard API(強烈推薦)

現代瀏覽器(Chrome 66+, Firefox 63+, Safari 13.1+, Edge 79+)均支援非同步 Clipboard API,僅在 HTTPS 或 localhost 且 使用者互動事件(click 等)中可用。

async function copyToClipboard(text) {
    try {
        await navigator.clipboard.writeText(text);
        console.log('複製成功');
    } catch (err) {
        console.error('複製失敗:', err);
        // 降級方案:使用 document.execCommand('copy')
        fallbackCopy(text);
    }
}

function fallbackCopy(text) {
    const textarea = document.createElement('textarea');
    textarea.value = text;
    textarea.style.position = 'fixed'; // 避免頁面跳動
    document.body.appendChild(textarea);
    textarea.select();
    try { document.execCommand('copy'); } catch (e) {}
    document.body.removeChild(textarea);
}

// 使用範例
document.getElementById('copy-btn').addEventListener('click', () => {
    copyToClipboard('要複製的內容');
});

總結建議

  1. 新專案:直接使用 navigator.clipboard.writeText() 搭配 execCommand 降級。
  2. 舊專案維護:若仍在用 Zero Clipboard/zclip,規劃移除 Flash 依賴。
  3. 複雜內容(HTML/圖片/檔案):參考 ClipboardItem 介面。
copyright © 萬盛學電腦網 all rights reserved