最近在學 JavaScript 時遇到一個需求:點擊按鈕把指定文字複製到剪貼簿。試過網路上能找到的各種土法煉鋼之後,最省力的方案是 clipboard.js。
套件資訊
專案位置:https://github.com/zenorocha/clipboard.js/tree/master
引入檔案:clipboard.js-master\dist\clipboard.min.js
官方附了各種 demo,包含固定文字複製、input 內容複製等,卡住時翻一翻往往就有靈感。
<script src="js/clipboard.min.js" type="text/javascript"></script>
<div id="btn" data-clipboard-text="1"> <span>Copy</span> </div>
<script>
var clipboard = new Clipboard('btn');
clipboard.on('success', function(e) {
e.clearSelection(); // 複製成功後清掉選取狀態
});
clipboard.on('error', function(e) {
// 複製失敗的處理
});
</script>
new Clipboard() 的參數可以是 id 也可以是 class,寫法與 CSS 選擇器一致,例如 '#btn' 或 '.btn'。上面範例直接寫 'btn' 也能動,是因為套件會自動判別,但建議還是把 # 或 . 補齊,避免元素名稱剛好重複時產生誤判。
若來源不是 data-clipboard-text,而是隔壁某個元素,可以用 target 指定。
new Clipboard('.btn', {
target: function(trigger) {
return trigger.nextElementSibling;
}
});
為每個項目動態設定 data-clipboard-text 即可,不必為每筆都初始化一次。
div.setAttribute("data-clipboard-text", "asdf");
PC 端主流瀏覽器支援度都很好。手機方面,Android 大致正常,iOS 則有問題,解法是把觸發元素從 div 改成 button 標籤——這與 iOS Safari 對非表單元素觸發複製行為的限制有關。
另外要留意,這個套件在部分環境下會退回到 execCommand('copy') 這條舊路徑,而該 API 已被標記為不建議使用,且要求頁面處於使用者互動的context中。因此初始化時機盡量放在 DOM ready 之後,觸發方式則維持真正的使用者點擊,不要用程式去呼叫 click()。