最近因為後端基礎較弱,硬著頭皮做了一陣子前端,花了兩週才搞定頁面裡的複製功能。過程瑣碎,怕忘記,記錄在這裡。
目前複製主流有四種方式:ZeroClipboard、Clipboard.js、execCommand、setData,至於其他只支援 IE 的方法就不討論了。
先引用壓縮版:
<script src="dist/clipboard.min.js"></script>
建立 Clipboard 物件('.btn' 會為所有 class 為 btn 的元素加上監聽):
var clipboard = new Clipboard('.btn');
clipboard.on('success', function(e) {
console.info('Action:', e.action);
console.info('Text:', e.text);
e.clearSelection();
});
clipboard.on('error', function(e) {
console.error('Action:', e.action);
});
HTML 只要這樣即可:
<button class="btn" data-clipboard-target="#foo">
使用清爽、測試通過。但因為項目只有一處用到複製,為了它加個外掛實在不划算,於是找到了近期的 execCommand 方法。
其實只要選中要複製的內容,執行 document.execCommand('copy', false, null) 就好。第一個參數是方法名,第二個是是否顯示預設 UI,第三個是可選參數清單(對 copy 來說後兩者用不到)。執行後依相容性可能有幾種情況:不支援 execCommand 會拋出異常、不支援 copy 方法回傳 false、成功回傳 true。
copy_target.focus();
copy_target.select();
try {
if(document.execCommand('copy', false, null)){
// 成功處理
} else {
// 失敗處理
}
} catch(err) {
// 失敗處理
}
項目用的是 Vue,且以 CoffeeScript 撰寫,需要把複製做成 Vue 的 method。問題在於:複製按鈕寫在 vex 模態框的 message 字串裡,而 Vue 函式只在渲染階段綁定,因此初次渲染時不會識別字串中的 v-on:click,無法直接從按鈕觸發。
解法是加一個隱藏的 input 作為「中繼」:讓 button 的 onclick 觸發隱藏 input 的 click,再由 input 的 @click 呼叫複製函式。
<input id="copyrelay" style="display: none;" @click="copy('cptg','cpbt')" />
<!-- vex.dialog.open 的 message 中: -->
<input id="cpbt" type="button" onclick="document.getElementById('copyrelay').click()" />
<input id="cptg" value="copy test" readonly />
然而又發現一個坑:display:none 的元素無法被 select,同樣也無法 focus、change 等,逐一測試後發現似乎只有 onclick 有效。此外,<input type="hidden"/> 也不能用那些事件;即使是正常顯示的元素,若 value 為空也無法觸發 select。
最終透過隱藏 input 中繼的方式,以比較優雅的姿勢實現了功能。雖然過程中踩了不少坑,但也讓我對事件綁定時機與元素狀態有了更深的理解。