DIV CSS 佈局教程網

點擊一鍵複製到剪貼簿:跨瀏覽器的歷史做法與現代正解
編輯:關於JavaScript     

「點一下把網址複製好」是個很常見的小功能。這份老程式碼示範了在 Clipboard API 出現之前,前端是如何分別對付 IE、Firefox 與 Opera 的。

歷史實作

function copy_clip() {
    var url = $("#back_info").html();            // 要複製的內容
    var txt = url.substring(url.indexOf(":") + 1, url.length);

    if (window.clipboardData) {                  // IE
        window.clipboardData.clearData();
        window.clipboardData.setData("Text", txt);
        alert('恭喜,複製成功!');
    } else if (navigator.userAgent.indexOf("Opera") != -1) {   // Opera
        window.location = txt;
    } else if (window.netscape) {                // 舊版 Firefox
        try {
            netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
        } catch (e) {
            alert("Firefox 的安全性限制了你進行剪貼簿操作,請在網址列輸入 about:config,"
                + "找到 signed.applets.codebase_principal_support 並設為 true");
            return false;
        }
        var clip = Components.classes["@mozilla.org/widget/clipboard;1"]
                     .createInstance(Components.interfaces.nsIClipboard);
        if (!clip) return;

        var trans = Components.classes["@mozilla.org/widget/transferable;1"]
                      .createInstance(Components.interfaces.nsITransferable);
        if (!trans) return;

        trans.addDataFlavor('text/unicode');
        var str = Components.classes["@mozilla.org/supports-string;1"]
                    .createInstance(Components.interfaces.nsISupportsString);
        str.data = txt;
        trans.setTransferData("text/unicode", str, txt.length * 2);

        var clipid = Components.interfaces.nsIClipboard;
        clip.setData(trans, null, clipid.kGlobalClipboard);
    }
}

這段程式為什麼現在不能用了

  • window.clipboardData 是 IE 專屬,已被淘汰。
  • Firefox 的 Components XPCOM 與 enablePrivilege 早已移除,window.netscape 也不再存在。
  • 它假設使用者會自己去改 about:config 開啟權限,這在現代瀏覽器的安全模型下根本不可能。

現代正解:navigator.clipboard

async function copyText(text) {
    try {
        await navigator.clipboard.writeText(text);
        console.log('複製成功');
    } catch (err) {
        // 非 HTTPS 或使用者未授權時的降級方案
        fallbackCopy(text);
    }
}

function fallbackCopy(text) {
    var ta = document.createElement('textarea');
    ta.value = text;
    ta.style.position = 'fixed';
    ta.style.opacity = '0';
    document.body.appendChild(ta);
    ta.select();
    var ok = document.execCommand('copy');   // 已標記為 deprecated,但仍是廣泛的降級手段
    document.body.removeChild(ta);
    console.log(ok ? '複製成功' : '複製失敗,請手動選取');
}

實務注意事項

  • 必須在 HTTPS(或 localhost)下:navigator.clipboard 只在安全內容中可用。
  • 必須由使用者手勢觸發:不能在 setTimeout 或 AJAX 回呼裡呼叫,否則會被瀏覽器擋下。
  • 不要再用 alert 當成功提示:改成頁面內的輕量提示(toast),並用 aria-live="polite" 讓輔助技術能播報。
  • 選字串而非 innerHTML:範例用 $("#back_info").html() 取值,若內容含標籤會被一起複製,請改用 .text() 或 .val()。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved