做 Web 前端時經常遇到「一鍵複製」的需求。看似應該是 document.execCommand('copy') 一行搞定的事,實際各家瀏覽器的支持情況差別很大。先把調研結果擺出來。
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。
var clip = Components.classes['@mozilla.org/widget/clipboard;1']
.createInstance(Components.interface.nsIClipboard);
Firefox 出於安全考慮,在 17 版本之後關閉了這個接口,僅 17 及更早版本可用。
出於安全策略,Chrome 沒有向頁面開放直接的剪貼板操作能力。由此可見,各瀏覽器在複製功能上的支持完全不統一,寫一套通用代碼幾乎不可能。
jhuckaby 寫的 Zero Clipboard 是當年的通用解法,利用 Flash 完成複製。只要瀏覽器裝有 Flash 插件就能工作,通過 ActionScript 補上了 JavaScript 的能力缺口。
實現原理:先在頁面中生成一個 Flash 對象標簽,讓透明的 Flash 浮層蓋在複製按鈕之上。用戶點擊的其實不是按鈕而是 Flash,需要複製的內容被傳入 Flash,再由 Flash 寫入系統剪貼板。
使用步驟:
ZeroClipboard.js 和 ZeroClipboard.swf 放入項目。兩者需位於同一路徑下,否則要用 ZeroClipboard.setMoviePath() 指定。<script type="text/javascript" src="ZeroClipboard.js"></script>
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() 綁定處理函數。
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 選中的舊方案作為兜底,並在失敗時提示用戶手動複製。