DIV CSS 佈局教程網

用 Web Uploader 實作多檔案上傳功能
編輯:關於JavaScript     

Web Uploader 只負責上傳的底層邏輯,不含任何 UI,這代表樣式與互動完全交給你決定。以下從零示範「多檔一般檔案上傳」與「多圖上傳含縮圖預覽」兩個版本。

引入資源

需要三樣東西:CSS、JS,以及初始化時指定的 SWF(供不支援現代 API 的舊瀏覽器降級使用)。

<!--引入CSS-->
<link rel="stylesheet" type="text/css" href="webuploader目錄/webuploader.css">
<!--引入JS-->
<script type="text/javascript" src="webuploader目錄/webuploader.js"></script>
<!--SWF 於初始化時指定-->

準備 DOM 骨架

只需要三個部分:存放檔案資訊的容器、選擇檔案的按鈕、開始上傳的按鈕。

<div id="uploader" class="wu-example">
    <!--用來存放檔案資訊-->
    <div id="thelist" class="uploader-list"></div>
    <div class="btns">
        <div id="picker">選擇檔案</div>
        <button id="ctlBtn" class="btn btn-default">開始上傳</button>
    </div>
</div>

初始化 Web Uploader

var uploader = WebUploader.create({
    // swf 檔案路徑
    swf: BASE_URL + '/js/Uploader.swf',
    // 檔案接收的服務端位址
    server: 'https://webuploader.duapp.com/server/fileupload.php',
    // 選擇檔案的按鈕,內部會依執行環境自動建立 input 或 flash
    pick: '#picker',
    // 不壓縮圖片;預設若為 jpeg,上傳前會先壓縮一次
    resize: false
});

顯示已選擇的檔案

由於 UI 邏輯要自己寫,這裡監聽 fileQueued 事件,把檔案插入列表。

// 當有檔案被加入佇列時
uploader.on('fileQueued', function (file) {
    $list.append(
        '<div id="' + file.id + '" class="item">' +
        '<h4 class="info">' + file.name + '</h4>' +
        '<p class="state">等待上傳...</p>' +
        '</div>'
    );
});

上傳進度

上傳過程中會持續派送 uploadProgress,參數包含檔案物件與當前百分比。

uploader.on('uploadProgress', function (file, percentage) {
    var $li = $('#' + file.id), $percent = $li.find('.progress .progress-bar');
    // 避免重複建立進度條
    if (!$percent.length) {
        $percent = $('<div class="progress progress-striped active">' +
            '<div class="progress-bar" role="progressbar" style="width: 0%"></div>' +
            '</div>').appendTo($li).find('.progress-bar');
    }
    $li.find('p.state').text('上傳中');
    $percent.css('width', percentage * 100 + '%');
});

成功與失敗處理

uploader.on('uploadSuccess', function (file) {
    $('#' + file.id).find('p.state').text('已上傳');
});
uploader.on('uploadError', function (file) {
    $('#' + file.id).find('p.state').text('上傳出錯');
});
uploader.on('uploadComplete', function (file) {
    $('#' + file.id).find('.progress').fadeOut();
});

不論成功或失敗,uploadComplete 都會觸發,所以清理進度條的工作放在這裡最合適。

進階:圖片上傳

相較一般檔案,圖片版多了三件事:檔案過濾、縮圖預覽、壓縮後上傳。

// 初始化 Web Uploader
var uploader = WebUploader.create({
    auto: true,                     // 選完檔案後自動上傳
    swf: BASE_URL + '/js/Uploader.swf',
    server: 'https://webuploader.duapp.com/server/fileupload.php',
    pick: '#filePicker',
    // 只允許選擇圖片
    accept: {
        title: 'Images',
        extensions: 'gif,jpg,jpeg,bmp,png',
        mimeTypes: 'image/*'
    }
});

同樣在 fileQueued 中處理畫面,差別是改用 uploader.makeThumb 產生預覽圖:

uploader.on('fileQueued', function (file) {
    var $li = $('<div id="' + file.id + '" class="file-item thumbnail">' +
        '<img><div class="info">' + file.name + '</div></div>'),
        $img = $li.find('img');

    $list.append($li);   // $list 為容器的 jQuery 物件

    // 建立縮略圖,thumbnailWidth x thumbnailHeight 為 100 x 100
    uploader.makeThumb(file, function (error, src) {
        if (error) {
            $img.replaceWith('<span>不能預覽</span>');
            return;
        }
        $img.attr('src', src);
    }, 100, 100);
});

這裡拿到的 src 是 Data URL,IE6、IE7 無法直接預覽,需要靠 Flash 或後端產生縮圖來替代。

剩下的狀態提示與前面相同,只是把成功狀態改成加上 class、由 CSS 控制外觀:

uploader.on('uploadSuccess', function (file) {
    $('#' + file.id).addClass('upload-state-done');
});
uploader.on('uploadError', function (file) {
    var $li = $('#' + file.id), $error = $li.find('div.error');
    if (!$error.length) { $error = $('<div class="error"></div>').appendTo($li); }
    $error.text('上傳失敗');
});
uploader.on('uploadComplete', function (file) {
    $('#' + file.id).find('.progress').remove();
});

整體而言,Web Uploader 把分片、暫停續傳、進度回報這些麻煩事處理好了,開發者只要專注在事件監聽與畫面呈現上,就能在幾十行內完成一個可用的多檔上傳介面。

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