原理:透明 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>
| 問題 | 原因 | 解決 |
|---|---|---|
| 按鈕無 Flash 透明層 | SWF 路徑錯誤、跨域、Flash 被禁用 | 同域部署 SWF、檢查 moviePath、用戶允許 Flash |
| Flash 位置偏移 | offsetParent 計算失效(relative/absolute/iframe) | 重寫 getDOMObjectPosition 用 jQuery offset() |
| 複製內容為空 | copy 回調返回錯誤值 | 文本用 .text(),輸入框用 .val() |
| HTTPS 頁面報混合內容 | SWF 以 HTTP 載入 | SWF 必須 HTTPS 同域部署 |
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');
});
});
| 方案 | IE | Edge | Chrome | Firefox | Safari | 移動端 | HTTPS 必需 |
|---|---|---|---|---|---|---|---|
| ZeroClipboard (Flash) | ✅ | ⚠️ 需允許 | ⚠️ 需允許 | ⚠️ 需允許 | ❌ 無 Flash | ❌ | 是 |
| Clipboard API | ❌ | ✅ 79+ | ✅ 66+ | ✅ 63+ | ✅ 13.1+ | ✅ | 是 |
| execCommand('copy') | ✅ 9+ | ✅ | ✅ | ✅ | ✅ | ⚠️ 部分 | 否 |
clipboard-polyfill 統一 API:import { writeText } from 'clipboard-polyfill'。Flash 時代已終結,擁抱原生 Clipboard API,簡單、安全、面向未來。