「一鍵複製」是常見需求。早期依賴 document.execCommand('copy') 配合 Flash (ZeroClipboard) 相容舊瀏覽器;現代瀏覽器已普遍支援異步的 Clipboard API,體驗更佳、無需第三方依賴。本文梳理演進歷程與最佳實踐。
async function copyText(text) {
try {
await navigator.clipboard.writeText(text);
toast('複製成功');
} catch (err) {
console.error('複製失敗:', err);
fallbackCopy(text); // 降級
}
}
// 按鈕綁定
document.getElementById('copyBtn').addEventListener('click', () => {
copyText(document.getElementById('target').textContent);
});
要求:HTTPS 或 localhost、用戶主動互動(click)觸發、需獲取 clipboard-write 權限(通常自動授予)。
function fallbackCopy(text) {
const ta = document.createElement('textarea');
ta.value = text;
ta.style.position = 'fixed';
ta.style.opacity = 0;
document.body.appendChild(ta);
ta.select();
try { document.execCommand('copy'); } catch(e) {}
document.body.removeChild(ta);
}
注意:execCommand 已棄用,僅作舊瀏覽器兜底。
原文提到的 jquery.zclip.js + ZeroClipboard.swf 方案,**已完全淘汰**(Flash 2020 年停止支援),請勿在新專案使用。
$('#copyDynamic').on('click', async () => {
await navigator.clipboard.writeText($('#dynamicInput').val());
});
iframe 中需父頁面授權 clipboard-write。clipboard-read 權限提示,寫入通常無提示。