DIV CSS 佈局教程網

JavaScript 實作點擊複製功能:從 IE 專屬寫法到現代 Clipboard API
編輯:JavaScript基礎知識     

「點一下就能複製」看似簡單,真正麻煩的是相容性。早期的做法幾乎都以 IE 的 clipboardData 為核心,其他瀏覽器只能想辦法繞路。以下依時間脈絡整理三種思路,最後給出現在該用的寫法。

最基礎的 IE 版本

function fuzhi() {
  var codeVal = document.getElementById('code').value;
  if (navigator.userAgent.toLowerCase().indexOf('ie') > -1) {
    clipboardData.setData('Text', codeVal);
    alert('已經複製到剪貼簿');
  } else {
    prompt('請手動複製:', codeVal);
  }
}

這段程式邏輯一目了然:IE 直接呼叫剪貼簿 API,其他瀏覽器就退回 prompt 讓使用者自己按 Ctrl+C。能用,但體驗落差很大。

方法一:逐一判斷瀏覽器

思路是依使用者代理或瀏覽器核心分派不同的複製實作。實務上判斷是否為 IE 核心有個流傳很廣的小技巧——「13 位元組法」,利用 \v 在 IE 中因垂直定位符被解析而長度為 1、其他瀏覽器則視為兩個字元的差異:

if ("\v" == "v") {
  // IE 核心:window.clipboardData 可用
} else {
  // 非 IE 核心
}

把整段封裝成一個函式,呼叫端只關心成功或失敗:

function clipBoard(object) {
  var copyTxt = document.getElementById(object).value;
  if (copy2Clipboard(copyTxt) !== false) {
    alert('複製成功');
  }
}

copy2Clipboard = function (txt) {
  if ("\v" == "v") {
    window.clipboardData.clearData();
    window.clipboardData.setData('Text', txt);
    return true;
  } else if (navigator.userAgent.indexOf('Firefox') > 0) {
    return true; // 需搭配使用者手動操作或擴充功能
  } else if (window.chrome) {
    return true;
  }
  alert('瀏覽器不支援');
  return false;
};

這個方法的弱點很明顯:瀏覽器種類太多,逐一枚舉不可能窮盡,而且判斷核心並不等於能保證複製成功。

方法二:Flash 間接處理

原理是建立一個 Flash 物件,把要複製的內容當成變數傳進去,由 Flash 寫入系統剪貼簿。只要瀏覽器支援 Flash,理論上幾乎都能work,其中最常用的是 ZeroClipboard。大致框架如下:

function checkClient(object) {
  var copyTxt = document.getElementById(object).value;
  if ("\v" != "v") {
    ZeroClipboard.setMoviePath('ZeroClipboard.swf');
    var clip = new ZeroClipboard.Client();
    clip.setHandCursor(true);
    clip.setText(copyTxt);
    clip.glue('d_clip_button'); // 綁定觸發用的 DOM id
  }
}

實測會遇到一個問題:在某些 CMS 系統中,IE 核心的頁面會跳出「該頁面目前無法顯示」或「該頁面已停止執行」的提示,原因是 JS 尚未載入完成就先去呼叫。既然問題出在 IE,就把 IE 獨立出來走原生複製,其他核心再用 Flash:

copy2Clipboard = function (txt) {
  if ("\v" == "v") {
    window.clipboardData.clearData();
    window.clipboardData.setData('Text', txt);
    return true;
  }
  return true; // 非 IE 交給 Flash 處理
};

不管走哪種方法,頁面上都需要準備一個承載內容的欄位與一個觸發點:

<input type="text" id="textinfo" value="要複製的內容" size="65"
       onmouseout="checkClient('textinfo')" />

<div id="d_clip_button" onclick="copyCode('textinfo')">複製地址</div>

<script>checkClient('textinfo');</script>

需要特別說明的是,Flash 早已停止支援,這條路今日只能作為歷史參考,不該再用於新專案。

現在該用的寫法:Clipboard API

現代瀏覽器已普遍支援非同步的 navigator.clipboard,用起來乾淨得多:

async function copyText(text) {
  try {
    await navigator.clipboard.writeText(text);
    alert('複製成功');
  } catch (err) {
    // 非同步 API 需在 https 或 localhost 環境下才能使用
    fallbackCopy(text);
  }
}

function fallbackCopy(text) {
  var ta = document.createElement('textarea');
  ta.value = text;
  ta.style.position = 'fixed';
  ta.style.opacity = '0';
  document.body.appendChild(ta);
  ta.select();
  var ok = document.execCommand('copy');
  document.body.removeChild(ta);
  alert(ok ? '複製成功' : '請手動複製');
}

這裡的 execCommand('copy') 是舊版的兜底方案:建立一個隱藏的 textarea、選取內容、執行複製指令,再把它移除。它的好處是不依賴 Flash,也不依賴特定瀏覽器核心,因此在非 HTTPS 環境或較舊的瀏覽器中仍然堪用。要注意的是,navigator.clipboard 必須在安全環境(HTTPS 或 localhost)下才可用,這是瀏覽器基於權限考量的限制。

小結

回頭看這段演進,可以發現一個規律:早期靠「判斷瀏覽器再分派程式碼」,本質上是把相容性成本丟給開發者;到了 Flash 時代改由外掛物件代勞;如今則由瀏覽器提供標準 API,並用 execCommand 作為過渡。寫新專案時,優先順序應是 Clipboard API → execCommand 兜底 → 提示使用者手動複製。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved