萬盛學電腦網

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

JavaScript 點擊圖片將圖片地址複製到剪貼板(現代 Clipboard API 方案)

現代方案:Clipboard API(推薦)

現代瀏覽器(Chrome 66+、Firefox 63+、Safari 13.1+、Edge 79+)支援異步 navigator.clipboard.writeText(),需 HTTPS 或 localhost,且需在用戶手勢(click)中調用。

完整實作

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>複製圖片地址到剪貼板</title>
  <style>
    .gallery { display: flex; gap: 16px; flex-wrap: wrap; }
    .gallery img { width: 200px; height: 150px; object-fit: cover; cursor: copy; border-radius: 8px; transition: transform 0.2s, box-shadow 0.2s; }
    .gallery img:hover { transform: scale(1.02); box-shadow: 0 4px 12px rgba(0,0,0,.15); }
    .toast { position: fixed; bottom: 20px; left: 50%; transform: translateX(-50%) translateY(100px); background: rgba(0,0,0,.8); color: #fff; padding: 12px 24px; border-radius: 8px; opacity: 0; transition: opacity 0.3s, transform 0.3s; z-index: 9999; }
    .toast.show { opacity: 1; transform: translateX(-50%) translateY(0); }
  </style>
</head>
<body>
  <div class="gallery" id="gallery">
    <img src="images/m01.jpg" data-url="https://example.com/images/m01.jpg" alt="圖片 1">
    <img src="images/m02.jpg" data-url="https://example.com/images/m02.jpg" alt="圖片 2">
    <img src="images/m03.jpg" data-url="https://example.com/images/m03.jpg" alt="圖片 3">
    <img src="images/m04.jpg" data-url="https://example.com/images/m04.jpg" alt="圖片 4">
  </div>
  <div class="toast" id="toast">地址已複製到剪貼板</div>

  <script>
  (() => {
    const gallery = document.getElementById('gallery');
    const toast = document.getElementById('toast');

    gallery.addEventListener('click', async (e) => {
      const img = e.target.closest('img');
      if (!img) return;

      // 優先使用 data-url(絕對地址),否則回退 src
      const url = img.dataset.url || img.src;

      try {
        await navigator.clipboard.writeText(url);
        showToast();
      } catch (err) {
        console.error('複製失敗:', err);
        fallbackCopyText(url);
      }
    });

    function showToast() {
      toast.classList.add('show');
      setTimeout(() => toast.classList.remove('show'), 2000);
    }

    // 降級方案:document.execCommand('copy')
    function fallbackCopyText(text) {
      const textarea = document.createElement('textarea');
      textarea.value = text;
      textarea.style.position = 'fixed';
      textarea.style.opacity = 0;
      document.body.appendChild(textarea);
      textarea.select();
      try {
        document.execCommand('copy');
        showToast();
      } catch (e) {
        alert('複製失敗,請手動複製:' + text);
      } finally {
        document.body.removeChild(textarea);
      }
    }
  })();
  </script>
</body>
</html>

關鍵點解析

  1. 事件委派:在容器監聽 click,通過 closest('img') 判斷目標,支援動態新增圖片。
  2. data-url 屬性:儲存絕對 URL(含域名),避免 src 為相對路徑導致複製後無效。
  3. Clipboard API:返回 Promise,異步非阻塞,需安全上下文(HTTPS)。
  4. 降級方案:execCommand('copy') 配合隱藏 textarea,兼容舊瀏覽器/HTTP 環境。
  5. 用戶反饋:Toast 提示,避免 alert 阻塞主執行緒。

常見坑點

  • HTTP 環境下 Clipboard API 不可用,必須降級。
  • 非用戶手勢觸發(如 setTimeout、網絡回調)會被拒絕。
  • execCommand 已棄用,未來可能移除,僅作過渡。
  • 複製富文本/HTML/圖片本身需用 navigator.clipboard.write([new ClipboardItem(...)])。
copyright © 萬盛學電腦網 all rights reserved