現代瀏覽器支援 navigator.clipboard.writeText()(需 HTTPS/安全上下文)。若需兼容 IE/舊版瀏覽器或 HTTP 環境,ZeroClipboard(Flash 方案)是經典選擇。本文記錄 ZeroClipboard 接入全過程及坑點修復。
jquery.js(或 Zepto)ZeroClipboard.min.jsZeroClipboard.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>
現象:複製按鈕顯示文字,但 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) {
// 上述修復邏輯
};
file:// 協議無法運行,需本地服務器(如 https://localhost)。'copy': function() {
// 文本節點用 .text(),表單元素用 .val()
return $('#' + $(this).attr('rel')).text(); // 或 .val()
}
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());
});
execCommand('copy')(已棄用但仍廣泛支援)。維舊專案用 ZeroClipboard 需修復定位 Bug、部署 SWF、應對 Flash 衰退;新專案**直接使用 Clipboard API + execCommand 降級**,簡單、安全、面向未來。