使用ZeroClipboard解決跨瀏覽器複製到剪貼簿的問題

王磊的部落格發表於2014-01-06

Zero Clipboard的實現原理
Zero Clipboard 利用透明的Flash讓其漂浮在複製按鈕之上,這樣其實點選的不是按鈕而是 Flash ,這樣將需要的內容傳入Flash,再通過Flash的複製功能把傳入的內容複製到剪貼簿。

Zero Clipboard的安裝方法
首先需要下載 Zero Clipboard的壓縮包,解壓後把資料夾中兩個檔案:ZeroClipboard.js 和 ZeroClipboard.swf 放入到你的專案中。
然後把在你要使用複製功能的頁面中引入Zero Clipboard的js檔案:ZeroClipboard.js
如下程式碼:
<script type="text/javascript" src="ZeroClipboard.js"></script>
注意:以上 ZeroClipboard.js, ZeroClipboard.swf需要放在同一路徑下。如果不在同一路徑,可使用ZeroClipboard.setMoviePath( “Flash路徑” );來設定ZeroClipboard.swf 地址
Zero Clipboard實現簡單跨瀏覽器複製
var clip = new ZeroClipboard.Client(); // 新建一個物件
clip.setHandCursor( true ); // 設定滑鼠為手型
clip.setText("哈哈"); // 設定要複製的文字。
// 註冊一個 button,引數為 id。點選這個 button 就會複製。
//這個 button 不一定要求是一個 input 按鈕,也可以是其他 DOM 元素。
clip.glue("copy-botton"); // 和上一句位置不可調換
這樣,這樣基本功能實現了,點選按鈕就可以複製設定好的文字了。你可能注意到了,待複製的文字是固定的,如果想要動態改變的怎麼辦,比如複製一個輸入框中的內容。不用擔心,下面會講到的。
Zero Clipboard的高階功能
1、reposition() 方法
因為按鈕上漂浮有一個 Flash 按鈕,所以當頁面大小發生變化時,Flash 按鈕可能會錯位,這樣就點不著了。 不要緊,Zero Clipboard 提供了一個 reposition() 方法,可以重新計算 Flash 按鈕的位置。我們可以將它繫結到 resize 事件上。如下面程式碼是在jQuery下實現的resize事件重新設定按鈕位置:
$(window).resize(function(){
clip.reposition();
});
2、hide() 和 show() 方法
這兩個方法可以隱藏和顯示 Flash 按鈕 。其中 show() 方法會呼叫 reposition() 方法。
3、setCSSEffects() 方法
當滑鼠移到按鈕上或點選時,由於有 Flash 按鈕的遮擋,所以像 css “:hover”, “:active” 等偽類可能會失效。setCSSEffects() 方法就是解決這個問題。首先我們需要將偽類改成類,比如:
#copy-botton:hover{border-color:#FF6633;}// 可以改成下面的 ":hover" 改成 ".hover"
#copy-botton.hover{border-color:#FF6633;}
我們可以呼叫 clip.setCSSEffects( true ); 這樣 Zero Clipboard 會自動為我們處理:將類 .hover 當成偽類 :hover 。
4、getHTML() 方法
如果你想自己例項一個 Flash ,不用 Zero Clipboard 的附著方法,那麼這個方法就可以幫上忙了。它接受兩個引數,分別為 Flash 的寬度和高度。返回的是 Flash 對應的 HTML 程式碼。例如:
var html = clip.getHTML( 150, 20 );
你可以用 innerHTML 或直接 document.write(); 進行輸出。
以下是測試輸出的組裝完畢的HTML 程式碼:
<embed id="ZeroClipboardMovie_1" src="zeroclipboard/ZeroClipboard.swf" loop="false" menu="false" quality="best" bgcolor="#ffffff" width="150" height="20" name="ZeroClipboardMovie_1" align="middle" allowScriptAccess="always" allowFullScreen="false" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" flashvars="id=1&width=150&height=20" wmode="transparent" />
IE 的 Flash JavaScript 通訊介面上有一個 bug 。你必須插入一個 object 標籤到一個已存在的 DOM 元素中。並且在寫入 innerHTML 之前請確保該元素已經 appendChild 方法插入到 DOM 中。
Zero Clipboard 事件處理
Zero Clipboard 提供了一些事件,你可以自定義函式處理這些事件。Zero Clipboard 事件處理函式為 addEventListener(); 例如當 Flash 完全載入後會觸發一個事件 “load” 。
clip.addEventListener( "load", function(client) {
alert("Flash 載入完畢!");
});
Zero Clipboard 會將 clip 物件作為引數傳入。即上例中的 “client” 。
還有 “load” 也可以寫成 “onLoad”,其他的事件也可以這樣。
其他事件還包括:
mouseOver 滑鼠移上事件
mouseOut 滑鼠移出事件
mouseDown 滑鼠按下事件
mouseUp 滑鼠鬆開事件
complete 複製成功事件
其中 mouseOver 事件和 complete 事件比較常用。
前面說過,如果需要動態改變待複製的內容,那 mouseOver 事件就可以派上用場了。例如需要動態複製一個 id 為 test 的輸入框中的值,我們可以在滑鼠 over 的時候重新設定值。
clip.addEventListener( "mouseOver", function(client) {
var test = document.getElementById("test");
client.setText( test.value ); // 重新設定要複製的值
});
//複製成功:
clip.addEventListener( "complete", function(){
alert("複製成功!");
});

 

相關文章