jQuery File Upload 插件成功回調函式完整用法與參數解析

Blueimp jQuery File Upload 是功能強大的檔案上傳元件，其成功回調函式為 done（或 always 區分成功/失敗）。

基本初始化與回調綁定

$('#fileupload').fileupload({
    url: '/api/upload',
    dataType: 'json',
    done: function (e, data) {
        // 上傳成功回調
        var response = data.result;
        console.log('上傳成功：', response);
        // 更新 UI、顯示縮圖、記錄檔案資訊等
    },
    fail: function (e, data) {
        // 上傳失敗回調
        console.error('上傳失敗：', data.errorThrown);
    },
    always: function (e, data) {
        // 無論成敗皆執行
        $('#progress').hide();
    },
    progressall: function (e, data) {
        // 總進度條更新
        var progress = parseInt(data.loaded / data.total * 100, 10);
        $('#progress .bar').css('width', progress + '%');
    }
});

回調參數 data 物件屬性詳解

常見進階需求

• 多檔案上傳後批次處理：在 done 累加 data.result.files，全部完成後統一提交表單。
• 拖曳上傳：預設支援，確保容器有 dropZone 設定。
• 斷點續傳：需搭配伺服器端支援 Content-Range，前端使用 blob.slice() 分片。

參考討論

9RIA 論壇完整範例：jquery.fileupload 回調函數詳解