萬盛學電腦網

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

JavaScript 跨瀏覽器複製到剪貼板:ZeroClipboard (Flash) 接入與現代 Clipboard API 遷移

歷史方案:ZeroClipboard (Flash)

原理:透明 Flash 覆蓋在按鈕上方,用戶點擊實際點擊 Flash,Flash 調用系統剪貼板 API。需引入 ZeroClipboard.js + ZeroClipboard.swf。

接入代碼(含定位修復)

<div class="buttonBox">
  <code rel="1"><span id="id_1">內容 1</span></code>
  <code rel="2"><span id="id_2">內容 2</span></code>
  <code rel="3"><span id="id_3">內容 3</span></code>
</div>

<script src="jquery.min.js"></script>
<script src="ZeroClipboard.min.js"></script>
<script>
$(function() {
    ZeroClipboard.setDefaults({ moviePath: 'ZeroClipboard.swf' });

    $('code').each(function() {
        var $btn = $(this);
        var id = $btn.attr('rel');
        var $target = $('#id_' + id);

        var clip = new ZeroClipboard($btn);
        clip.on('load', function(client) {
            client.on('complete', function(client, args) {
                alert('已複製: ' + args.text);
            });
        });
        clip.on('error', function(event) {
            console.error('ZeroClipboard error:', event.name);
        });
    });

    // 【關鍵修復】iframe/定位容器導致 Flash 位置偏移
    // 重寫 getDOMObjectPosition 使用 jQuery offset()
    ZeroClipboard.prototype.getDOMObjectPosition = function(obj) {
        var $obj = $(obj);
        var pos = $obj.offset(); // 相對文檔絕對位置
        return {
            left: pos.left,
            top: pos.top,
            width: $obj.outerWidth(),
            height: $obj.outerHeight()
        };
    };
});
</script>

ZeroClipboard 核心坑點總結

問題原因解決
按鈕無 Flash 透明層SWF 路徑錯誤、跨域、Flash 被禁用同域部署 SWF、檢查 moviePath、用戶允許 Flash
Flash 位置偏移offsetParent 計算失效(relative/absolute/iframe)重寫 getDOMObjectPosition 用 jQuery offset()
複製內容為空copy 回調返回錯誤值文本用 .text(),輸入框用 .val()
HTTPS 頁面報混合內容SWF 以 HTTP 載入SWF 必須 HTTPS 同域部署

現代標準方案:Clipboard API(推薦)

async function copyToClipboard(text) {
    try {
        // 需 HTTPS + 用戶手勢(click 事件內)
        await navigator.clipboard.writeText(text);
        return true;
    } catch (err) {
        console.warn('Clipboard API 失敗,降級:', err);
        return fallbackCopy(text);
    }
}

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

// 統一調用
$('.copy-btn').click(function() {
    var text = $(this).data('clipboard-text') || $(this).prev().text();
    copyToClipboard(text).then(function(ok) {
        if (ok) alert('複製成功');
        else alert('複製失敗,請手動 Ctrl+C');
    });
});

兼容性對比

方案IEEdgeChromeFirefoxSafari移動端HTTPS 必需
ZeroClipboard (Flash)✅⚠️ 需允許⚠️ 需允許⚠️ 需允許❌ 無 Flash❌是
Clipboard API❌✅ 79+✅ 66+✅ 63+✅ 13.1+✅是
execCommand('copy')✅ 9+✅✅✅✅⚠️ 部分否

遷移建議

  1. 新項目**直接用 Clipboard API + execCommand 降級**。
  2. 存量 ZeroClipboard 專案:若無 IE 需求,立即遷移;若需支援 IE,保留並做好 Flash 退役預案(2020 年底 Adobe 停止支援 Flash)。
  3. 引入 clipboard-polyfill 統一 API:import { writeText } from 'clipboard-polyfill'。

Flash 時代已終結,擁抱原生 Clipboard API,簡單、安全、面向未來。

copyright © 萬盛學電腦網 all rights reserved