前言：之前的三篇介紹了下bootstrap table的一些常見用法，發現博主對這種扁平化的風格有點著迷了。前兩天做一個excel匯入的功能，前端使用原始的input type='file'這種標籤，效果不忍直視，於是博主下定決心要找一個好看的上傳元件換掉它。既然bootstrap開源，那麼社群肯定有很多關於它的元件，肯定也有這種常見的上傳元件吧。經過一番查詢，功夫不負有心人，還是被博主找到了這個元件：bootstrap fileinput。關於這個元件的簡單應用，部落格園大牛伍華聰寫過一篇基於Metronic的Bootstrap開發框架經驗總結（5）--Bootstrap檔案上傳外掛File Input的使用

原始碼以及API地址：

一、效果展示

 1、原始的input type='file'，簡直不忍直視。

2、不做任何裝飾的bootstrap fileinput：（bootstrap fileinput初級進化）

3、bootstrap fileinput高階進化：中文化、可拖拽上傳、副檔名校驗（如果不是需要的檔案，不讓上傳）

拖拽上傳

上傳中

4、bootstrap fileinput究極進化：允許同時多執行緒上傳多個檔案。

上傳中

上傳完成後

二、程式碼示例

怎麼樣？效果如何？不要急，我們一步一步來實現以上的效果。

1、cshtml頁面

首先引入需要的js和css檔案。

　　　　　　  //bootstrap fileinput
            bundles.Add(new ScriptBundle("~/Content/bootstrap-fileinput/js").Include(
                        "~/Content/bootstrap-fileinput/js/fileinput.min.js",
                        
 
"~/Content/bootstrap-fileinput/js/fileinput_locale_zh.js"));
            bundles.Add(new StyleBundle("~/Content/bootstrap-fileinput/css").Include(
                        "~/Content/bootstrap-fileinput/css/fileinput.min.css"));

@Scripts.Render("~/Content/bootstrap-fileinput/js")
@Styles.Render("~/Content/bootstrap-fileinput/css")

然後定義input type='file'標籤

<form>
    <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
        <div class="modal-dialog modal-lg" role="document">
            <div class="modal-content">
                <div class="modal-header">
                    <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
                    <h4 class="modal-title" id="myModalLabel">請選擇Excel檔案</h4>
                </div>
                <div class="modal-body">
                    <a href="~/Data/ExcelTemplate/Order.xlsx" class="form-control" style="border:none;">下載匯入模板</a>
                    <input type="file" name="txt_file" id="txt_file" multiple class="file-loading" />
                </div></div>
        </div>
    </div>
</form>

重點看這一句：

<input type="file" name="txt_file" id="txt_file" multiple class="file-loading" />

multiple表示允許同時上傳多個檔案，class=“file-loading”表示標籤的樣式。這裡很重要，如果class="file"，則中文化不能生效。

2、js初始化

$(function () {
    //0.初始化fileinput
    var oFileInput = new FileInput();
    oFileInput.Init("txt_file", "/api/OrderApi/ImportOrder");
});

//初始化fileinput
var FileInput = function () {
    var oFile = new Object();

    //初始化fileinput控制元件（第一次初始化）
    oFile.Init = function(ctrlName, uploadUrl) {
    var control = $('#' + ctrlName);

    //初始化上傳控制元件的樣式
    control.fileinput({
        language: 'zh', //設定語言
        uploadUrl: uploadUrl, //上傳的地址
        allowedFileExtensions: ['jpg', 'gif', 'png'],//接收的檔案字尾
        showUpload: true, //是否顯示上傳按鈕
        showCaption: false,//是否顯示標題
        browseClass: "btn btn-primary", //按鈕樣式     
        //dropZoneEnabled: false,//是否顯示拖拽區域
        //minImageWidth: 50, //圖片的最小寬度
        //minImageHeight: 50,//圖片的最小高度
        //maxImageWidth: 1000,//圖片的最大寬度
        //maxImageHeight: 1000,//圖片的最大高度
        //maxFileSize: 0,//單位為kb，如果為0表示不限制檔案大小
        //minFileCount: 0,
        maxFileCount: 10, //表示允許同時上傳的最大檔案個數
        enctype: 'multipart/form-data',
        validateInitialCount:true,
        previewFileIcon: "<i class='glyphicon glyphicon-king'></i>",
        msgFilesTooMany: "選擇上傳的檔案數量({n}) 超過允許的最大數值{m}！",
    });

    //匯入檔案上傳完成之後的事件
    $("#txt_file").on("fileuploaded", function (event, data, previewId, index) {
        $("#myModal").modal("hide");
        var data = data.response.lstOrderImport;
        if (data == undefined) {
            toastr.error('檔案格式型別不正確');
            return;
        }
        //1.初始化表格
        var oTable = new TableInit();
        oTable.Init(data);
        $("#div_startimport").show();
    });
}
    return oFile;
};

說明：

（1）fileinput()方法裡面傳入的是一個json資料，它裡面有很多屬性，每個屬性代表著初始化上傳控制元件的時候的特性，如果這些屬性都不設定，則表示使用預設的設定。如果園友們想看看它裡面有哪些屬性，可以開啟fileinput.js的原始碼，在它的最後如圖：

這些屬性如果不特意設定，就會使用預設值。

（2）$("#txt_file").on("fileuploaded", function (event, data, previewId, index) {}這個方法註冊上傳完成後的回撥事件。也就是後天處理上傳的檔案之後進入這個方法裡面處理。

3、後臺C#對應的方法

 還記得在js裡面初始化控制元件方法fileinput()裡面有一個引數url嗎，這個url對應的值就指示C#後天對應的處理方法。還是貼出後臺的處理方法。

　　　　 [ActionName("ImportOrder")]
        public object ImportOrder()
        {
            var oFile = HttpContext.Current.Request.Files["txt_file"];
            var lstOrderImport = new List<DTO_TO_ORDER_IMPORT>();

            #region 0.資料準備
            var lstExistOrder = orderManager.Find();
            var lstOrderNo = lstExistOrder.Select(x => x.ORDER_NO).ToList();
            var lstTmModel = modelManager.Find();
            var lstTmMaterial = materialManager.Find();
            //var iMax_Import_Index = lstExistOrder.Max(x => x.IMPORT_INDEX);
            //iMax_Import_Index = iMax_Import_Index == null ? 0 : iMax_Import_Index.Value;
            #endregion

            #region 1.通過Stream得到Workbook物件
            IWorkbook workbook = null;
            if (oFile.FileName.EndsWith(".xls"))
            {
                workbook = new HSSFWorkbook(oFile.InputStream);
            }
            else if(oFile.FileName.EndsWith(".xlsx"))
            {
                workbook = new XSSFWorkbook(oFile.InputStream);
            }
            if (workbook == null)
            {
                return new { };
            }

            //...............處理excel的邏輯


            //orderManager.Add(lstOrder);
            lstOrderImport = lstOrderImport.OrderBy(x => x.IMPORT_STATU).ToList();
            return new { lstOrderImport = lstOrderImport };
        }

由於博主的專案是上傳excel，所以這裡用是用的NPOI的邏輯，如果是上傳圖片等檔案，可以使用GDI去處理圖片。

4、同時上傳多個檔案

同時上傳多個檔案的時候，前臺會發送多個非同步的請求到後臺，也就是說，當同時上傳三個檔案的時候，後臺的ImportOrder方法會進入三次。這樣就能使用多執行緒同時去處理三個檔案。

三、總結

關於bootstrap fileinput的基礎使用大概就介紹完了，其實就是一個上傳的元件，也不存在什麼高階用法。重點是把介面做得更加友好，更好的增加使用者體驗。

2015-12-01

經過今早2個小時的忙碌，原始碼終於整理出來了。有興趣的下載看看。原始碼下載。