Bootstrap文件上傳插件File Input是一個不錯的文件上傳控件,但是搜索使用到的案例不多,使用的時候,也是一步一個腳印一樣摸著石頭過河,這個控件在界面呈現(xiàn)上,叫我之前使用過的Uploadify 好看一些,功能也強大些,本文主要基于我自己的框架代碼案例,介紹其中文件上傳插件File Input的使用。關(guān)于Uploadify的控件介紹,可以參考我之前的隨筆介紹《基于MVC4+EasyUI的Web開發(fā)框架形成之旅--附件上傳組件uploadify的使用》。
這個插件主頁地址是:http://plugins.krajee.com/file-input,可以從這里看到很多Demo的代碼展示:http://plugins.krajee.com/file-basic-usage-demo。
這是一個增強的 HTML5 文件輸入控件,是一個 Bootstrap 3.x 的擴展,實現(xiàn)文件上傳預(yù)覽,多文件上傳等功能。
一般情況下,我們需要引入下面兩個文件,插件才能正常使用:
bootstrap-fileinput/css/fileinput.min.css
bootstrap-fileinput/js/fileinput.min.js
簡單的界面效果如下所示,和眾多上傳文件控件一樣,可以接受各種類型的文件。當(dāng)然,我們也可以指定具體接受的文件類型等功能。
如果需要考慮中文化,那么還需要引入文件:
bootstrap-fileinput/js/fileinput_locale_zh.js
這樣基于MVC的Bundles集合,我們把它們所需要的文件加入到集合里面即可。
//添加對bootstrap-fileinput控件的支持 css_metronic.Include("~/Content/MyPlugins/bootstrap-fileinput/css/fileinput.min.css"); js_metronic.Include("~/Content/MyPlugins/bootstrap-fileinput/js/fileinput.min.js"); js_metronic.Include("~/Content/MyPlugins/bootstrap-fileinput/js/fileinput_locale_zh.js");
這樣我們在頁面里面,就可以呈現(xiàn)出中文的界面說明和提示了,如下界面所示。
一般情況下,我們可以定義一個JS的通用函數(shù),用來初始化這個插件控件的,如下JS的函數(shù)代碼所示。
//初始化fileinput控件(第一次初始化)function initFileInput(ctrlName, uploadUrl) { var control = $('#' + ctrlName); control.fileinput({ language: 'zh', //設(shè)置語言 uploadUrl: uploadUrl, //上傳的地址 allowedFileExtensions : ['jpg', 'png','gif'],//接收的文件后綴 showUpload: false, //是否顯示上傳按鈕 showCaption: false,//是否顯示標(biāo)題 browseClass: "btn btn-primary", //按鈕樣式 previewFileIcon: "<i class='glyphicon glyphicon-king'></i>", });}
頁面代碼里面,我們放置一個文件上傳控件,如下代碼所示。
<div class="row" style="height: 500px"> <input id="file-Portrait1" type="file"> </div>
這樣我們腳本代碼的初始化代碼如下:
//初始化fileinput控件(第一次初始化) initFileInput("file-Portrait", "/User/EditPortrait");
這樣就完成了控件的初始化了,如果我們需要上傳文件,那么還需要JS的代碼處理客戶端上傳的事件,同時也需要MVC后臺控制器處理文件的保存操作。
例如我對窗體數(shù)據(jù)的保存處理代碼如下所示。
//添加記錄的窗體處理 formValidate("ffAdd", function (form) { $("#add").modal("hide"); //構(gòu)造參數(shù)發(fā)送給后臺 var postData = $("#ffAdd").serializeArray(); $.post(url, postData, function (json) { var data = $.parseJSON(json); if (data.Success) { //增加肖像的上傳處理 initPortrait(data.Data1);//使用寫入的ID進行更新 $('#file-Portrait').fileinput('upload'); //保存成功 1.關(guān)閉彈出層,2.刷新表格數(shù)據(jù) showTips("保存成功"); Refresh(); } else { showError("保存失敗:" + data.ErrorMessage, 3000); } }).error(function () { showTips("您未被授權(quán)使用該功能,請聯(lián)系管理員進行處理。"); }); });
其中我們注意到文件保存的處理邏輯代碼部分:
//增加肖像的上傳處理 initPortrait(data.Data1);//使用寫入的ID進行更新 $('#file-Portrait').fileinput('upload');
第一行代碼就是重新構(gòu)建上傳的附加內(nèi)容,如用戶的ID信息等,這樣我們就可以根據(jù)這些ID來構(gòu)建一些額外的數(shù)據(jù)給后臺上傳處理了。
這個函數(shù)主要就是重新給ID賦值,方便上傳的時候,獲取最新的附加參數(shù),這個和Uploadify的處理模式一樣的。
//初始化圖像信息 function initPortrait(ctrlName, id) { var control = $('#' + ctrlName); var imageurl = '/PictureAlbum/GetPortrait?id=' + id + '&r=' + Math.random(); //重要,需要更新控件的附加參數(shù)內(nèi)容,以及圖片初始化顯示 control.fileinput('refresh', { uploadExtraData: { id: id }, initialPreview: [ //預(yù)覽圖片的設(shè)置 "<img src='" + imageurl + "' class='file-preview-image' alt='肖像圖片' title='肖像圖片'>", ], }); }
前面我們看到,我上傳的地址為:"/User/EditPortrait",這個后臺的函數(shù)我也公布一下,希望給大家一個完整的案例代碼學(xué)習(xí)。
/// <summary> /// 上傳用戶頭像圖片 /// </summary> /// <param name="id">用戶的ID</param> /// <returns></returns> public ActionResult EditPortrait(int id) { CommonResult result = new CommonResult(); try { var files = Request.Files; if (files != null && files.Count > 0) { UserInfo info = BLLFactory<User>.Instance.FindByID(id); if (info != null) { var fileData = ReadFileBytes(files[0]); result.Success = BLLFactory<User>.Instance.UpdatePersonImageBytes(UserImageType.個人肖像, id, fileData); } } } catch (Exception ex) { result.ErrorMessage = ex.Message; } return ToJsonContent(result); }
這樣我們就構(gòu)建了上面的用戶肖像的保存處理邏輯了,文件可以正常的保存到后臺的文件系統(tǒng)里面,同時數(shù)據(jù)庫里面記錄一些必備的信息。
當(dāng)然,除了用來處理用戶的肖像圖片,我們也可以用來構(gòu)建圖片相冊的處理操作的,具體界面如下所示。
這部分的初始化代碼如下所示:
//初始化fileinput控件(第一次初始化) $('#file-Portrait').fileinput({ language: 'zh', //設(shè)置語言 uploadUrl: "/FileUpload/Upload", //上傳的地址 allowedFileExtensions : ['jpg', 'png','gif'],//接收的文件后綴, maxFileCount: 100, enctype: 'multipart/form-data', showUpload: true, //是否顯示上傳按鈕 showCaption: false,//是否顯示標(biāo)題 browseClass: "btn btn-primary", //按鈕樣式 previewFileIcon: "<i class='glyphicon glyphicon-king'></i>", msgFilesTooMany: "選擇上傳的文件數(shù)量({n}) 超過允許的最大數(shù)值{m}!", });
如果有興趣,可以繼續(xù)參考系列文章:
基于Metronic的Bootstrap開發(fā)框架經(jīng)驗總結(jié)(1)-框架總覽及菜單模塊的處理
基于Metronic的Bootstrap開發(fā)框架經(jīng)驗總結(jié)(2)--列表分頁處理和插件JSTree的使用
基于Metronic的Bootstrap開發(fā)框架經(jīng)驗總結(jié)(3)--下拉列表Select2插件的使用
基于Metronic的Bootstrap開發(fā)框架經(jīng)驗總結(jié)(4)--Bootstrap圖標(biāo)的提取和利用
基于Metronic的Bootstrap開發(fā)框架經(jīng)驗總結(jié)(5)--Bootstrap文件上傳插件File Input的使用