DIV CSS 佈局教程網

JavaScript 在瀏覽器端解壓 ZIP 並預覽檔案的實作
編輯:關於JavaScript     

為什麼要在前端解壓 ZIP?

如果只考慮標準瀏覽器,把資料打包成壓縮檔再由伺服器送到用戶端,帶寬與傳輸時間都能省下不少——聽起來確實是個不錯的思路。

當前端程式碼量龐大、又夾帶大量圖片時,這種做法的價值就更明顯了:伺服器把 JS、CSS、JPG、PNG 等資源打包成一個 ZIP 送出,瀏覽器負責解壓;CSS 以動態方式產生後插入 DOM,JS 透過 globalEval 直接執行,圖片則把 Blob 轉成 image 流再放進頁面。

HTML5 支援讀取 Blob(二進位大型物件,File 也繼承自 Blob),並能把它轉成圖片流、文字流或其他形式,這正是瀏覽器得以處理 application/zip 的基礎。

要在瀏覽器內完成解壓,需要載入四支 JS:UnZipArchive.js 依賴 zip.js、mime-type.js 與 jQuery。以下是最小可運行的範例。

<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<script src="https://gildas-lormeau.github.io/zip.js/demos/zip.js"></script>
<script src="https://gildas-lormeau.github.io/zip.js/demos/mime-types.js"></script>
<script src="https://apps.bdimg.com/libs/jquery/1.9.0/jquery.js"></script>
<script src="https://files.cnblogs.com/files/diligenceday/UnZipArchive.js"></script>
</head>
<body>
<h2>demo</h2>
<div><input type="file" id="file"></div>
<ul id="dir"></ul>
<script>
$("#file").change(function (e) {
    var file = this.files[0];
    window.un = new UnZipArchive(file);
    un.getData(function () {
        var arr = un.getEntries();   // 取得壓縮檔內所有檔案與資料夾
        var str = "";
        for (var i = 0; i < arr.length; i++) {
            str += "<li onclick=download('"+arr[i]+"')>" + arr[i] + "</li>";
        }
        $("#dir").html(str);
    });
});
var download = function (filename) { un.download(filename); };
</script>
</body>
</html>

UnZipArchive.js 是自行封裝的類別,若遇到問題歡迎隨時回饋。

完整 DEMO 與相容性說明

<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<script src="https://gildas-lormeau.github.io/zip.js/demos/zip.js"></script>
<script src="https://gildas-lormeau.github.io/zip.js/demos/mime-types.js"></script>
<script src="https://apps.bdimg.com/libs/jquery/1.9.0/jquery.js"></script>
<style> code{ display: block; padding: 10px; background: #eee; } </style>
</head>
<body>
<div>
<h1>相容性</h1>
<div>
<p>zip.js 可在所有 Chrome 與 Firefox 上執行,Safari 6 與 IE10 以上亦可使用。</p>
<p>若要在 IE9 與 Safari 上執行,需要兩個設定:</p>
<code>1:zip.useWebWorkers == false</code>
<code>2:另外載入 https://bitbucket.org/lindenlab/llsd/raw/7d2646cd3f9b/js/typedarray.js</code>
</div>
<h2>demo</h2>
<div><input type="file" id="file"></div>
<ul id="dir"></ul>
<script>
$("#file").change(function (e) {
    var file = this.files[0];
    window.un = new UnZipArchive(file);
    un.getData(function () {
        var arr = un.getEntries();
        var str = "";
        for (var i = 0; i < arr.length; i++) {
            str += "<li onclick=download('"+arr[i]+"')>" + arr[i] + "</li>";
        }
        $("#dir").html(str);
    });
});
var download = function (filename) { un.download(filename); };
</script>
</div>
<script>
zip.workerScriptsPath = "https://gildas-lormeau.github.io/zip.js/demos/";

/**
 * @desc 解壓縮類別
 * @return UnZipArchive 的實例
 */
var UnZipArchive = function (blob) {
    if (!blob) { alert("參數不正確,需要一個 Blob 型別的參數"); return; }
    if (!(blob instanceof Blob)) { alert("參數不是 Blob 型別"); return; }
    function noop() {};
    this.entries = {};
    this.zipReader = {};
    var _this = this;
    this.length = 0;
    this.onend = noop;
    this.onerror = noop;
    this.onprogress = noop;
    var def = this.defer = new $.Deferred();   // 建立延遲物件
    zip.createReader(new zip.BlobReader(blob), function (zipReader) {
        _this.zipReader = zipReader;
        zipReader.getEntries(function (entries) {
            _this.entries = entries;
            def.resolve();                     // 繼續執行佇列
        });
    }, this.error.bind(_this));
};

/**
 * @desc 把 Blob 轉成 dataURL
 */
UnZipArchive.readBlobAsDataURL = function (blob, callback) {
    var f = new FileReader();
    f.onload = function (e) { callback(e.target.result); };
    f.readAsDataURL(blob);
};

$.extend(UnZipArchive.prototype, {
    /** @desc 取得壓縮檔中所有項目名稱 @return ArrayList */
    "getEntries": function () {
        var result = [];
        for (var i = 0, len = this.entries.length; i < len; i++) {
            result.push(this.entries[i].filename);
        }
        return result;
    },
    /** @desc 依檔名取得 Entry @return Entry */
    "getEntry": function (filename) {
        for (var i = 0, len = this.entries.length; i < len; i++) {
            if (this.entries[i].filename === filename) {
                return this.entries[i];
            }
        }
    },
    /** @desc 下載檔案 @param filename @return void */
    "download": function (filename, cb, runoninit) {
        var _this = this;
        this.defer = this.defer.then(function () {
            var def = $.Deferred();
            if (!filename) return;
            if (runoninit) { return runoninit(); }
            var entry = _this.getEntry(filename);
            if (!entry) return;
            entry.getData(new zip.BlobWriter(zip.getMimeType(entry.filename)), function (data) {
                if (!cb) {
                    UnZipArchive.readBlobAsDataURL(data, function (dataUrl) {
                        var downloadButton = document.createElement("a"),
                            URL = window.webkitURL || window.mozURL || window.URL;
                        downloadButton.href = dataUrl;
                        downloadButton.download = filename;
                        downloadButton.click();
                        def.resolve(dataUrl);
                        _this.onend();
                    });
                } else {
                    cb(data);
                    def.resolve(data);
                }
            });
            return def;
        });
    },
    /** @desc 取得對應的 Blob;也可直接傳入解壓完成後的 callback */
    "getData": function (filename, fn) {
        if (typeof filename === "string") {
            this.download(filename, function (blob) { fn && fn(blob); });
        } else if (typeof filename === "function") {
            this.download("test", null, function () { filename(); });
        }
    },
    "error": function () {
        this.onerror(this);
        throw new Error("壓縮檔解壓失敗");
    }
});
</script>
</body>
</html>

真正難纏的其實不是解壓本身,而是瀏覽器之間的相容性落差。

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