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 於初始化時指定-->
只需要三個部分:存放檔案資訊的容器、選擇檔案的按鈕、開始上傳的按鈕。
<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>
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 把分片、暫停續傳、進度回報這些麻煩事處理好了,開發者只要專注在事件監聽與畫面呈現上,就能在幾十行內完成一個可用的多檔上傳介面。