DIV CSS 佈局教程網

用 jQuery 把頁面局部內容另存為 HTML 檔
編輯:JQuery特效代碼     

即時通訊的對話紀錄、報表頁的統計結果、表單填完的內容——這些情境常有「存成檔案」的需求。本文示範一個不依賴後端的做法:用 JavaScript 開新視窗、寫入內容、再觸發瀏覽器的「另存新檔」。

程式碼

// 將聊天記錄保存到本地
function save_record() {
    // 以當前日期作為檔名
    var time = new Date();
    var filename = time.toLocaleDateString();

    // 取得頁面上要保存的部分內容
    var record = $("#contentList").html();

    // 開啟新視窗準備寫入
    var winRecord = window.open('about:blank', '_blank', 'top=500');
    winRecord.document.open("text/html", "utf-8");
    winRecord.document.write(
        "<html>"
        + "<style>body,ul,li{margin:0px;padding:0px;list-style:none;font-size:12px;}</style>"
        + "<body>" + record + "</body></html>"
    );
    winRecord.document.execCommand("SaveAs", true, filename + ".html");
    winRecord.close();
}

逐步拆解

取內容:$("#contentList").html() 抓的是該元素的內部 HTML,包含標籤本身,所以貼到新文件後結構仍然完整。若只要純文字,改用 .text()。

開視窗:window.open('about:blank', '_blank', 'top=500') 開一個空白視窗。這裡有個實務陷阱——瀏覽器會攔截非同步產生的彈出視窗,因此 window.open() 必須直接寫在使用者點擊的處理函式中,不能放在 setTimeout 或 Ajax 回呼裡,否則會被靜默封鎖。

寫入:document.open("text/html", "utf-8") 指定文件型別與編碼,這一步不可省,否則中文容易變成亂碼。接著 document.write() 把包了基本樣式的完整 HTML 寫進去。

觸發另存:execCommand("SaveAs", ...) 會叫出瀏覽器的另存對話框,第二個參數 true 表示顯示對話框,第三個是預設檔名。

必須知道的限制

document.execCommand() 是已被淘汰的(deprecated)API,僅在舊版 IE 與部分瀏覽器上有效,在現代 Chrome、Firefox 中已不再保證運作,新專案不應採用。

現代做法是改用 Blob 加 URL.createObjectURL():

function saveContent(selector, filename) {
    var html = "<!DOCTYPE html><html><head><meta charset=\"utf-8\">"
             + "<title>" + filename + "</title></head><body>"
             + $(selector).html()
             + "</body></html>";

    var blob = new Blob([html], { type: "text/html;charset=utf-8" });
    var url = URL.createObjectURL(blob);
    var a = document.createElement("a");

    a.href = url;
    a.download = filename + ".html";
    document.body.appendChild(a);
    a.click();
    document.body.removeChild(a);

    URL.revokeObjectURL(url);   // 釋放記憶體
}

這個版本不開新視窗、不跳出另存對話框,直接下載檔案,體驗更順,也能在手機瀏覽器上運作。要注意的是:使用者若真的需要「另存新檔」的選擇權,Blob 方案就沒有辦法保留了,這是兩種做法在體驗上的主要取捨。

最後提醒一個安全觀念:把使用者輸入的內容直接 document.write() 到新文件,等於把那段內容當成 HTML 執行。若其中夾帶 script,就會形成 XSS。若內容來源不完全可信,應先做轉義處理再寫入。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved