萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 複製到剪貼板完整方案:從 execCommand 到 Clipboard API

現代標準方案:Clipboard API (推薦)

/**
 * 現代複製到剪貼板
 * @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);
}

舊版瀏覽器特殊處理(IE / 老 Firefox)

原文中的 netscape.security.PrivilegeManager、Components.classes 僅適用於 Firefox 舊版擴展環境,**現代網頁已完全不可用**。

  • IE 11:支持 execCommand('copy')
  • IE ≤ 10:僅支持 window.clipboardData.setData('Text', text)(僅限可信站點)

// IE 專用判斷
if (window.clipboardData && window.clipboardData.setData) {
    // IE 10/11
    window.clipboardData.setData('Text', text);
    return true;
}

複製富文本 / HTML / 圖片


// 複製 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 })]);
}

權限與安全檢查清單

  1. HTTPS 必須:Clipboard API 僅在安全上下文可用
  2. 用戶交互觸發:必須在 click、keydown 等事件處理函數中調用
  3. 權限查詢:navigator.permissions.query({name:'clipboard-write'}) 可預檢
  4. CSP 策略:確保 clipboard-write 未被阻擋

總結

2024 年,**Clipboard API 是首選**,配合 execCommand 降級可覆蓋 99%+ 現代瀏覽器。封裝統一 copyToClipboard(text) 函數,外部注入 Toast 提示,業務代碼一行調用,優雅解耦。放棄對 IE 老版本、Firefox 擴展 API 的特殊兼容,專注現代標準才是長久之計。

copyright © 萬盛學電腦網 all rights reserved