萬盛學電腦網

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

跨瀏覽器複製文字到剪貼簿:從 document.execCommand 到 Clipboard API

「一鍵複製」是常見需求。早期依賴 document.execCommand('copy') 配合 Flash (ZeroClipboard) 相容舊瀏覽器;現代瀏覽器已普遍支援異步的 Clipboard API,體驗更佳、無需第三方依賴。本文梳理演進歷程與最佳實踐。

方案一:現代標準 —— 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 權限(通常自動授予)。

方案二:降級方案 —— execCommand + 臨時 textarea

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 已棄用,僅作舊瀏覽器兜底。

方案三:歷史產物 —— ZeroClipboard (Flash)

原文提到的 jquery.zclip.js + ZeroClipboard.swf 方案,**已完全淘汰**(Flash 2020 年停止支援),請勿在新專案使用。

複製動態輸入框內容

$('#copyDynamic').on('click', async () => {
  await navigator.clipboard.writeText($('#dynamicInput').val());
});

常見坑點

  • 在 iframe 中需父頁面授權 clipboard-write。
  • Safari 早期版本需 clipboard-read 權限提示,寫入通常無提示。
  • 大量文字(>1MB)可能失敗,建議分段或提供下載檔案替代。
copyright © 萬盛學電腦網 all rights reserved