1. 程式人生 > >螞蟻老碼農——JavaScript復制內容到剪貼板

螞蟻老碼農——JavaScript復制內容到剪貼板

JavaScript 架構 Java

最近一個活動頁面中有一個小需求,用戶點擊或者長按就可以復制內容到剪貼板,記錄一下實現過程和遇到的坑。
常見方法
查了一下萬能的Google,現在常見的方法主要是以下兩種:

第三方庫:clipboard.js
原生方法:document.execCommand()

分別來看看這兩種方法是如何使用的。
clipboard.js
這是clipboard的官網:clipboardjs.com/,看起來就是這麽的簡單。
引用
直接引用: <script src="dist/clipboard.min.js"></script>
包: npm install clipboard --save ,然後 import Clipboard from ‘clipboard‘;

使用
從輸入框復制
現在頁面上有一個 <input> 標簽,我們需要復制其中的內容,我們可以這樣做:
<input id="demoInput" value="hello world">
<button class="btn" data-clipboard-target="#demoInput">點我復制</button>
import Clipboard from ‘clipboard‘;
const btnCopy = new Clipboard(‘btn‘);
註意到,在 <button> 標簽中添加了一個 data-clipboard-target 屬性,它的值是需要復制的 <input> 的 id,顧名思義是從整個標簽中復制內容。
直接復制
有的時候,我們並不希望從 <input> 中復制內容,僅僅是直接從變量中取值。如果在 Vue 中我們可以這樣做:
<button class="btn" :data-clipboard-text="copyValue">點我復制</button>
import Clipboard from ‘clipboard‘;
const btnCopy = new Clipboard(‘btn‘);
this.copyValue = ‘hello world‘;
事件
有的時候我們需要在復制後做一些事情,這時候就需要回調函數的支持。
在處理函數中加入以下代碼:
// 復制成功後執行的回調函數
clipboard.on(‘success‘, function(e) {
console.info(‘Action:‘, e.action); // 動作名稱,比如:Action: copy
console.info(‘Text:‘, e.text); // 內容,比如:Text:hello word
console.info(‘Trigger:‘, e.trigger); // 觸發元素:比如:<button class="btn" :data-clipboard-text="copyValue">點我復制</button>
e.clearSelection(); // 清除選中內容
});

// 復制失敗後執行的回調函數
clipboard.on(‘error‘, function(e) {
console.error(‘Action:‘, e.action);
console.error(‘Trigger:‘, e.trigger);
});
小結
文檔中還提到,如果在單頁面中使用 clipboard ,為了使得生命周期管理更加的優雅,在使用完之後記得 btn.destroy() 銷毀一下。
clipboard 使用起來是不是很簡單。但是,就為了一個 copy 功能就使用額外的第三方庫是不是不夠優雅,這時候該怎麽辦?那就用原生方法實現唄。
document.execCommand()方法
先看看這個方法在 MDN 上是怎麽定義的:

which allows one to run commands to manipulate the contents of the editable region.

意思就是可以允許運行命令來操作可編輯區域的內容,註意,是可編輯區域。
定義

bool = document.execCommand(aCommandName, aShowDefaultUI, aValueArgument)

方法返回一個 Boolean 值,表示操作是否成功。

aCommandName :表示命令名稱,比如: copy, cut 等(更多命令見命令);
aShowDefaultUI:是否展示用戶界面,一般情況下都是 false;
aValueArgument:有些命令需要額外的參數,一般用不到;

兼容性
這個方法在之前的兼容性其實是不太好的,但是好在現在已經基本兼容所有主流瀏覽器了,在移動端也可以使用。

使用
從輸入框復制
現在頁面上有一個 <input> 標簽,我們想要復制其中的內容,我們可以這樣做:
<input id="demoInput" value="hello world">
<button id="btn">點我復制</button>
const btn = document.querySelector(‘#btn‘);
btn.addEventListener(‘click‘, () => {
const input = document.querySelector(‘#demoInput‘);
input.select();
if (document.execCommand(‘copy‘)) {
document.execCommand(‘copy‘);
console.log(‘復制成功‘);
}
})
其它地方復制
有的時候頁面上並沒有 <input> 標簽,我們可能需要從一個 <div> 中復制內容,或者直接復制變量。
還記得在 execCommand() 方法的定義中提到,它只能操作可編輯區域,也就是意味著除了 <input>、<textarea> 這樣的輸入域以外,是無法使用這個方法的。
這時候我們需要曲線救國。
<button id="btn">點我復制</button>
const btn = document.querySelector(‘#btn‘);
btn.addEventListener(‘click‘,() => {
const input = document.createElement(‘input‘);
document.body.appendChild(input);
input.setAttribute(‘value‘, ‘聽說你想復制我‘);
input.select();
if (document.execCommand(‘copy‘)) {
document.execCommand(‘copy‘);
console.log(‘復制成功‘);
}
document.body.removeChild(input);
})
算是曲線救國成功了吧。在使用這個方法時,遇到了幾個坑。
遇到的坑
在Chrome下調試的時候,這個方法時完美運行的。然後到了移動端調試的時候,坑就出來了。
對,沒錯,就是你,ios。。。

點擊復制時屏幕下方會出現白屏抖動,仔細看是拉起鍵盤又瞬間收起
知道了抖動是由於什麽產生的就比較好解決了。既然是拉起鍵盤,那就是聚焦到了輸入域,那只要讓輸入域不可輸入就好了,在代碼中添加 input.setAttribute(‘readonly‘, ‘readonly‘); 使這個 <input> 是只讀的,就不會拉起鍵盤了。

無法復制
這個問題是由於 input.select() 在ios下並沒有選中全部內容,我們需要使用另一個方法來選中內容,這個方法就是 input.setSelectionRange(0, input.value.length);。

完整代碼如下:
const btn = document.querySelector(‘#btn‘);
btn.addEventListener(‘click‘,() => {
const input = document.createElement(‘input‘);
input.setAttribute(‘readonly‘, ‘readonly‘);
input.setAttribute(‘value‘, ‘hello world‘);
document.body.appendChild(input);
input.setSelectionRange(0, 9999);
if (document.execCommand(‘copy‘)) {
document.execCommand(‘copy‘);
console.log(‘復制成功‘);
}
document.body.removeChild(input);
})

螞蟻老碼農——JavaScript復制內容到剪貼板