/**
* 現代複製到剪貼板
* @param {string} text - 要複製的文本
* @returns {Promise} 是否成功
*/
async function copyToClipboardModern(text) {
try {
await navigator.clipboard.writeText(text);
showToast('已複製到剪貼板!');
return true;
} catch (err) {
console.error('複製失敗:', err);
return copyToClipboardFallback(text); // 降級
}
}
// 使用
copyBtn.addEventListener('click', () => copyToClipboardModern('要複製的內容'));
支持:Chrome 66+、Firefox 63+、Safari 13.1+、Edge 79+(需 HTTPS 或 localhost,且需用戶交互觸發)
document.execCommand('copy') (廣泛兼容)
function copyToClipboardLegacy(text) {
return new Promise((resolve) => {
// 創建隱藏 textarea
const textarea = document.createElement('textarea');
textarea.value = text;
// 防止頁面跳動
textarea.style.position = 'fixed';
textarea.style.opacity = '0';
textarea.style.left = '-9999px';
document.body.appendChild(textarea);
// 選中並複製
textarea.select();
// iOS Safari 需要 setSelectionRange
if (navigator.userAgent.match(/ipad|iphone/i)) {
textarea.setSelectionRange(0, text.length);
}
let success = false;
try {
success = document.execCommand('copy');
} catch (e) {
success = false;
}
document.body.removeChild(textarea);
if (success) {
showToast('已複製到剪貼板!');
} else {
showToast('複製失敗,請手動 Ctrl+C', 'error');
}
resolve(success);
});
}
/**
* 統一複製函數:自動選擇最佳方案
* @param {string} text
* @param {Object} options
* @returns {Promise}
*/
async function copyToClipboard(text, options = {}) {
const {
successMsg = '複製成功!',
errorMsg = '複製失敗,請手動複製',
toast = showToast // 外部注入 Toast 函數
} = options;
// 1. 優先 Clipboard API (現代瀏覽器、HTTPS)
if (navigator.clipboard && window.isSecureContext) {
try {
await navigator.clipboard.writeText(text);
toast?.(successMsg, 'success');
return true;
} catch (e) {
// 降級到 execCommand
}
}
// 2. 降級:execCommand + textarea
return copyToClipboardLegacy(text).then(success => {
if (!success) toast?.(errorMsg, 'error');
return success;
});
}
// 簡易 Toast 實現
function showToast(msg, type = 'info') {
const el = document.createElement('div');
el.textContent = msg;
el.style.cssText = `
position:fixed; bottom:20px; left:50%; transform:translateX(-50%);
padding:12px 24px; border-radius:8px; color:white; z-index:9999;
background:${type==='error'?'#e74c3c':'#27ae60'};
box-shadow:0 4px 12px rgba(0,0,0,0.15); animation:fadeIn 0.3s;
`;
document.body.appendChild(el);
setTimeout(() => { el.style.opacity='0'; setTimeout(()=>el.remove(),300); }, 2000);
}
原文中的 netscape.security.PrivilegeManager、Components.classes 僅適用於 Firefox 舊版擴展環境,**現代網頁已完全不可用**。
execCommand('copy')window.clipboardData.setData('Text', text)(僅限可信站點)
// IE 專用判斷
if (window.clipboardData && window.clipboardData.setData) {
// IE 10/11
window.clipboardData.setData('Text', text);
return true;
}
// 複製 HTML 內容(支持粘貼到 Word/郵件客戶端保留格式)
async function copyHtmlToClipboard(html, plainTextFallback) {
try {
const blob = new Blob([html], { type: 'text/html' });
const data = [new ClipboardItem({ 'text/html': blob, 'text/plain': new Blob([plainTextFallback], {type:'text/plain'}) })];
await navigator.clipboard.write(data);
return true;
} catch (e) {
console.error('HTML 複製失敗:', e);
return false;
}
}
// 複製圖片
async function copyImageToClipboard(imageUrl) {
const response = await fetch(imageUrl);
const blob = await response.blob();
await navigator.clipboard.write([new ClipboardItem({ [blob.type]: blob })]);
}
navigator.permissions.query({name:'clipboard-write'}) 可預檢clipboard-write 未被阻擋2024 年,**Clipboard API 是首選**,配合 execCommand 降級可覆蓋 99%+ 現代瀏覽器。封裝統一 copyToClipboard(text) 函數,外部注入 Toast 提示,業務代碼一行調用,優雅解耦。放棄對 IE 老版本、Firefox 擴展 API 的特殊兼容,專注現代標準才是長久之計。