DIV CSS 佈局教程網

JavaScript 實現文本複製:各瀏覽器支持情況實測
編輯:JavaScript綜合知識     

做 Web 前端時經常遇到「一鍵複製」的需求。看似應該是 document.execCommand('copy') 一行搞定的事,實際各家瀏覽器的支持情況差別很大。先把調研結果擺出來。

一、IE:三種途徑

function copy(txtid) {
  var txtObj = document.getElementById(txtid);
  if (window.clipboardData) {
    // 僅 IE 支持此對象,Firefox、Chrome 均不支持

    // 途徑 1:通過 clipboardData 對象實現
    // window.clipboardData.clearData();
    // window.clipboardData.setData("Text", txtObj.value);

    // 途徑 2:先選中文本,再執行複製命令
    // txtObj.select();
    // document.execCommand("Copy");

    // 途徑 3:通過 TextRange 對象實現,可以不用先選中內容
    txtObj.createTextRange().execCommand("Copy");
  }
}

三種做法各有側重:clipboardData.setData 直接寫入剪貼板;select() 加 execCommand 先選中再複製;createTextRange().execCommand("Copy") 則省去了選中步驟。其中 execCommand 在 Firefox 中會報語法錯誤,在 Chrome 中返回 false。

二、Firefox:XPCOM 接口

var clip = Components.classes['@mozilla.org/widget/clipboard;1']
                      .createInstance(Components.interface.nsIClipboard);

Firefox 出於安全考慮,在 17 版本之後關閉了這個接口,僅 17 及更早版本可用。

三、Chrome:不提供剪貼板操作

出於安全策略,Chrome 沒有向頁面開放直接的剪貼板操作能力。由此可見,各瀏覽器在複製功能上的支持完全不統一,寫一套通用代碼幾乎不可能。

方案:Zero Clipboard 庫

jhuckaby 寫的 Zero Clipboard 是當年的通用解法,利用 Flash 完成複製。只要瀏覽器裝有 Flash 插件就能工作,通過 ActionScript 補上了 JavaScript 的能力缺口。

實現原理:先在頁面中生成一個 Flash 對象標簽,讓透明的 Flash 浮層蓋在複製按鈕之上。用戶點擊的其實不是按鈕而是 Flash,需要複製的內容被傳入 Flash,再由 Flash 寫入系統剪貼板。

使用步驟:

  1. 下載並解壓,把 ZeroClipboard.js 和 ZeroClipboard.swf 放入項目。兩者需位於同一路徑下,否則要用 ZeroClipboard.setMoviePath() 指定。
  2. 引入腳本:<script type="text/javascript" src="ZeroClipboard.js"></script>
  3. 調用:
var clip = new ZeroClipboard.Client(); // 新建 clip 對象
clip.setHandCursor(true);              // 鼠標顯示手型
clip.setText("hello,world");           // 設置要複製的文本
clip.glue("copy-botton");              // 綁定按鈕 id,點擊即可複製

注意:由於基於 Flash,出於安全限制必須在 Web 容器(Apache、Tomcat 等)中運行,直接雙擊打開本地 Flash 文件不會加載,按鈕會呈現「假死」狀態。

常用方法:reposition() 防止頁面尺寸變化時 Flash 按鈕錯位;hide() / show() 控制顯示;setCSSEffects() 解決 Flash 遮擋導致的 hover 樣式失效(把 :hover 改為 .hover)。

常用事件:load、mouseOver、mouseOut、mouseDown、mouseUp、complete,通過 addEventListener() 綁定處理函數。

方案:jquery.zclip

Zero Clipboard 是原生 JavaScript 實現的,jquery.zclip 則用 jQuery 對它做了封裝。項目中已經在用 jQuery 的話,推薦後者,體積更小,API 也更符合 jQuery 的習慣。

今天該怎麼做

需要明確的是,Flash 已於 2020 年底停止支持,上述兩個庫在現代瀏覽器中完全無法運行,本文的價值在於記錄當時的技術處境。

現在的標準答案是 navigator.clipboard.writeText()。它基於異步 API,支持 Chrome、Edge、Firefox、Safari 各主流版本,代碼只需一行:

await navigator.clipboard.writeText("hello,world");

使用時有兩個前提:一是必須在 HTTPS 或 localhost 環境下(安全上下文);二是必須由用戶手勢觸發,如果在異步回調中調用,部分瀏覽器會拒絕。因此實踐中常見的做法是:先用檢測判斷 API 是否可用,不可用時退回 document.execCommand('copy') 配合 textarea 選中的舊方案作為兜底,並在失敗時提示用戶手動複製。

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