瀏覽器基於安全考量,長期限制 JavaScript 直接存取系統剪貼簿。各大瀏覽器支援度不一,導致開發者必須採用不同策略甚至引入 Flash 方案。本文整理實測結果與主流解決方案。
| 瀏覽器 | 支援方式 | 備註 |
|---|---|---|
| IE | window.clipboardData.setData()document.execCommand('Copy')TextRange.execCommand('Copy') | 多種專有 API,相容性最好 |
| Firefox (≤17) | Components.classes['@mozilla.org/widget/clipboard;1'] | 17 版後因安全性移除介面 |
| Chrome / 新版 Firefox / Edge | 無原生 JS API 開放 | 需透過 Flash 或使用者互動觸發 |
利用透明的 Flash 物件覆蓋在按鈕上方,使用者點擊按鈕實際觸發 Flash,再由 Flash 呼叫 System.setClipboard() 寫入剪貼簿。
ZeroClipboard.js 與 ZeroClipboard.swf 放入專案同目錄<script src="ZeroClipboard.js"></script>var clip = new ZeroClipboard.Client();
clip.setHandCursor(true);
clip.setText("要複製的文字");
clip.glue("copy-button-id"); // 綁定按鈕
file:// 協定 Flash 會被阻擋:hover 樣式失效,需呼叫 setCSSEffects() 修正語法更簡潔,適合已引入 jQuery 的舊專案維護:
$("#copy-btn").zclip({
path: "ZeroClipboard.swf",
copy: function(){ return $("#text-input").val(); },
afterCopy: function(){ alert("複製成功"); }
});
現代瀏覽器(Chrome 66+, Firefox 63+, Safari 13.1+, Edge 79+)均支援非同步 Clipboard API,僅在 HTTPS 或 localhost 且 使用者互動事件(click 等)中可用。
async function copyToClipboard(text) {
try {
await navigator.clipboard.writeText(text);
console.log('複製成功');
} catch (err) {
console.error('複製失敗:', err);
// 降級方案:使用 document.execCommand('copy')
fallbackCopy(text);
}
}
function fallbackCopy(text) {
const textarea = document.createElement('textarea');
textarea.value = text;
textarea.style.position = 'fixed'; // 避免頁面跳動
document.body.appendChild(textarea);
textarea.select();
try { document.execCommand('copy'); } catch (e) {}
document.body.removeChild(textarea);
}
// 使用範例
document.getElementById('copy-btn').addEventListener('click', () => {
copyToClipboard('要複製的內容');
});
navigator.clipboard.writeText() 搭配 execCommand 降級。ClipboardItem 介面。