萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

跨瀏覽器剪貼板復制:jQuery ZClip 插件實戰指南

為什麼需要 ZClip?

IE 專屬的 clipboardData.setData() 只能在 IE 生效,現代瀏覽器長期缺乏原生 JS 復制 API(直到 Clipboard API 普及)。ZClip 利用一個隱形 Flash(ZeroClipboard.swf)橋接系統剪貼板,實現了 IE6+、Chrome、Firefox、Safari、Opera 10+ 的全兼容復制。

快速上手三步走

1. 引入依賴

<script src="js/jquery.js"></script>
<script src="js/jquery.zclip.min.js"></script>

2. 準備 HTML

<textarea id="mytext">請輸入內容</textarea><br/>
<a href="#" id="copy_input" class="copy">復制內容</a>

觸發元素可以是 <a>、<button> 等任何可點擊元素。

3. 初始化插件

$(function() {
  $('#copy_input').zclip({
    path: 'js/ZeroClipboard.swf', // Flash 文件路徑,必須正確
    copy: function() {            // 返回要復制的字符串
      return $('#mytext').val();
    },
    afterCopy: function() {       // 復制成功回調
      $('

核心配置詳解

參數類型說明
pathStringZeroClipboard.swf 絕對/相對路徑,跨域需注意 Flash 安全策略
copyFunction/String返回復制內容;若為字符串則直接使用
afterCopyFunction復制成功後執行,this 指向觸發元素
beforeCopyFunction復制前執行,返回 false 可取消操作
clickAfterBoolean默認 true,復制後是否觸發默認點擊行為

不同來源內容的復制寫法

  • 輸入框:copy: function() { return $('#mytext').val(); }
  • 普通元素文本:copy: function() { return $('#mydiv').text(); }
  • 屬性值:copy: function() { return $(this).attr('data-url'); }
  • 動態生成:copy: '固定字符串' 或拼接變量

常見坑與解決

  1. Flash 路徑錯誤:控制台報 404,請用絕對路徑或確保相對路徑相對當前頁面而非 JS 文件。
  2. HTTPS 頁面引用 HTTP Flash:會被瀏覽器阻擋,需同協議部署 swf。
  3. 觸發元素不可見:Flash 覆蓋在元素上方,若元素 display:none 或 opacity:0 會失效,改用 visibility:hidden 或移出視口。
  4. 移動端不支持:Flash 在移動端基本不可用,現代項目請改用 Clipboard API + 降級方案。

現代替代方案:Clipboard API

async function copyText(text) {
  try {
    await navigator.clipboard.writeText(text);
    console.log('復制成功');
  } catch (err) {
    // 降級:舊版瀏覽器用 ZClip 或 document.execCommand('copy')
  }
}

新項目優先用 Clipboard API,僅在必須兼容舊瀏覽器時引入 ZClip。

copyright © 萬盛學電腦網 all rights reserved