萬盛學電腦網

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

ZeroClipboard 跨瀏覽器複製到剪貼板完整接入指南

方案選型

現代瀏覽器支援 navigator.clipboard.writeText()(需 HTTPS/安全上下文)。若需兼容 IE/舊版瀏覽器或 HTTP 環境,ZeroClipboard(Flash 方案)是經典選擇。本文記錄 ZeroClipboard 接入全過程及坑點修復。

所需資源

  • jquery.js(或 Zepto)
  • ZeroClipboard.min.js
  • ZeroClipboard.swf(Flash 載體,必須同域部署)

官方下載:https://www.steamdev.com/zclip/

基礎接入代碼

<button id="d_clip_button" data-clipboard-target="fe_text">點擊複製</button>
<input id="fe_text" value="Testing text." />

<script src="jquery.min.js"></script>
<script src="ZeroClipboard.min.js"></script>
<script>
$(function() {
    // 設置 SWF 路徑(必須正確,否則不顯示按鈕)
    ZeroClipboard.setDefaults({ moviePath: 'ZeroClipboard.swf' });

    var clip = new ZeroClipboard($('#d_clip_button'));

    clip.on('load', function(client) {
        console.log('ZeroClipboard loaded');
        client.on('complete', function(client, args) {
            console.log('已複製: ' + args.text);
            alert('複製成功!');
        });
    });

    clip.on('error', function(event) {
        console.error('ZeroClipboard error:', event.name);
        // Flash 被禁用、版本過低等
    });
});
</script>

常見坑點與修復

1. Flash 按鈕位置偏移(iframe/定位容器導致)

現象:複製按鈕顯示文字,但 Flash 透明層未覆蓋在按鈕上方,點擊無效。

原因:ZeroClipboard 通過 getDOMObjectPosition 計算按鈕絕對位置,使用 offsetLeft/offsetTop 相對 offsetParent 累加。若按鈕在 position: relative/absolute/fixed 容器或 iframe 中,計算邏輯失效。

修復:修改 ZeroClipboard.js 中 getDOMObjectPosition 方法,改用 jQuery .position()(相對定位父元素)或 .offset()(相對文檔):

// ZeroClipboard.js 內部
getDOMObjectPosition: function(obj, stopObj) {
    var info = {
        left: 0, top: 0,
        width: obj.width || obj.offsetWidth,
        height: obj.height || obj.offsetHeight
    };
    if (obj && obj !== stopObj) {
        // 原代碼:info.left += obj.offsetLeft; info.top += obj.offsetTop;
        // 修復:使用 jQuery position() 獲取相對定位父元素的偏移
        var $obj = $(obj);
        var pos = $obj.position(); // 或 $obj.offset() 視情況
        info.left += pos.left;
        info.top += pos.top;
    }
    return info;
}

若專案不便修改庫源碼,可在初始化後重寫該方法:

ZeroClipboard.prototype.getDOMObjectPosition = function(obj, stopObj) {
    // 上述修復邏輯
};

2. Flash 安全沙箱限制

  • SWF 必須與頁面**同域**(協議、域名、端口一致)。
  • 本地 file:// 協議無法運行,需本地服務器(如 https://localhost)。
  • Chrome 57+ 默認阻擋 Flash,需用戶手動允許,體驗極差。

3. 複製內容獲取方式

'copy': function() {
    // 文本節點用 .text(),表單元素用 .val()
    return $('#' + $(this).attr('rel')).text(); // 或 .val()
}

現代替代方案:Clipboard API(推薦新項目)

async function copyText(text) {
    try {
        await navigator.clipboard.writeText(text);
        console.log('複製成功');
    } catch (err) {
        console.error('複製失敗:', err);
        // 降級:舊式 execCommand
        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 { document.execCommand('copy'); } catch(e) {}
    document.body.removeChild(textarea);
}

// 統一調用
$('#copyBtn').click(function() {
    copyText($('#target').text());
});
  • HTTPS + 用戶手勢(click 事件內)可直接使用。
  • 無 Flash 依賴、無安全風險、移動端完美支援。
  • 舊瀏覽器自動降級到 execCommand('copy')(已棄用但仍廣泛支援)。

總結

維舊專案用 ZeroClipboard 需修復定位 Bug、部署 SWF、應對 Flash 衰退;新專案**直接使用 Clipboard API + execCommand 降級**,簡單、安全、面向未來。

copyright © 萬盛學電腦網 all rights reserved