Bootstrap文件上傳插件File Input是一個(gè)不錯(cuò)的文件上傳控件扯旷,但是搜索使用到的案例不多雄妥,使用的時(shí)候蟹漓,也是一步一個(gè)腳印一樣摸著石頭過(guò)河炕横,這個(gè)控件在界面呈現(xiàn)上,叫我之前使用過(guò)的Uploadify 好看一些葡粒,功能也強(qiáng)大些份殿,本文主要基于我自己的框架代碼案例,介紹其中文件上傳插件File Input的使用嗽交。關(guān)于Uploadify的控件介紹卿嘲,可以參考我之前的隨筆介紹《基于MVC4+EasyUI的Web開(kāi)發(fā)框架形成之旅--附件上傳組件uploadify的使用》。
1夫壁、文件上傳插件File Input介紹
這個(gè)插件主頁(yè)地址是:http://plugins.krajee.com/file-input拾枣,可以從這里看到很多Demo的代碼展示:http://plugins.krajee.com/file-basic-usage-demo。
這是一個(gè)增強(qiáng)的 HTML5 文件輸入控件盒让,是一個(gè) Bootstrap 3.x 的擴(kuò)展梅肤,實(shí)現(xiàn)文件上傳預(yù)覽,多文件上傳等功能邑茄。
一般情況下凭语,我們需要引入下面兩個(gè)文件,插件才能正常使用:
bootstrap-fileinput/css/fileinput.min.css
bootstrap-fileinput/js/fileinput.min.js
簡(jiǎn)單的界面效果如下所示撩扒,和眾多上傳文件控件一樣似扔,可以接受各種類型的文件吨些。當(dāng)然,我們也可以指定具體接受的文件類型等功能炒辉。
如果需要考慮中文化豪墅,那么還需要引入文件:
bootstrap-fileinput/js/fileinput_locale_zh.js
這樣基于MVC的Bundles集合,我們把它們所需要的文件加入到集合里面即可黔寇。
//添加對(duì)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");
這樣我們?cè)陧?yè)面里面偶器,就可以呈現(xiàn)出中文的界面說(shuō)明和提示了,如下界面所示缝裤。
2屏轰、文件上傳插件File Input的使用
一般情況下,我們可以定義一個(gè)JS的通用函數(shù)憋飞,用來(lái)初始化這個(gè)插件控件的霎苗,如下JS的函數(shù)代碼所示。
//初始化fileinput控件(第一次初始化)
function initFileInput(ctrlName, uploadUrl) {
var control = $('#' + ctrlName);
control.fileinput({
language: 'zh', //設(shè)置語(yǔ)言
uploadUrl: uploadUrl, //上傳的地址
allowedFileExtensions : ['jpg', 'png','gif'],//接收的文件后綴
showUpload: false, //是否顯示上傳按鈕
showCaption: false,//是否顯示標(biāo)題
browseClass: "btn btn-primary", //按鈕樣式
previewFileIcon: "<i class='glyphicon glyphicon-king'></i>",
});
}
頁(yè)面代碼里面榛做,我們放置一個(gè)文件上傳控件唁盏,如下代碼所示。
<div class="row" style="height: 500px">
<input id="file-Portrait1" type="file">
</div>
這樣我們腳本代碼的初始化代碼如下:
//初始化fileinput控件(第一次初始化)
initFileInput("file-Portrait", "/User/EditPortrait");
這樣就完成了控件的初始化了检眯,如果我們需要上傳文件厘擂,那么還需要JS的代碼處理客戶端上傳的事件,同時(shí)也需要MVC后臺(tái)控制器處理文件的保存操作锰瘸。
例如我對(duì)窗體數(shù)據(jù)的保存處理代碼如下所示刽严。
//添加記錄的窗體處理
formValidate("ffAdd", function (form) {
$("#add").modal("hide");
//構(gòu)造參數(shù)發(fā)送給后臺(tái)
var postData = $("#ffAdd").serializeArray();
$.post(url, postData, function (json) {
var data = $.parseJSON(json);
if (data.Success) {
//增加肖像的上傳處理
initPortrait(data.Data1);//使用寫入的ID進(jìn)行更新
$('#file-Portrait').fileinput('upload');
//保存成功 1.關(guān)閉彈出層,2.刷新表格數(shù)據(jù)
showTips("保存成功");
Refresh();
}
else {
showError("保存失敗:" + data.ErrorMessage, 3000);
}
}).error(function () {
showTips("您未被授權(quán)使用該功能避凝,請(qǐng)聯(lián)系管理員進(jìn)行處理舞萄。");
});
});
其中我們注意到文件保存的處理邏輯代碼部分:
//增加肖像的上傳處理
initPortrait(data.Data1);//使用寫入的ID進(jìn)行更新
$('#file-Portrait').fileinput('upload');
第一行代碼就是重新構(gòu)建上傳的附加內(nèi)容,如用戶的ID信息等恕曲,這樣我們就可以根據(jù)這些ID來(lái)構(gòu)建一些額外的數(shù)據(jù)給后臺(tái)上傳處理了鹏氧。
這個(gè)函數(shù)主要就是重新給ID賦值渤涌,方便上傳的時(shí)候佩谣,獲取最新的附加參數(shù),這個(gè)和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"调鬓,這個(gè)后臺(tái)的函數(shù)我也公布一下,希望給大家一個(gè)完整的案例代碼學(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.個(gè)人肖像, id, fileData);
}
}
}
catch (Exception ex)
{
result.ErrorMessage = ex.Message;
}
return ToJsonContent(result);
}
這樣我們就構(gòu)建了上面的用戶肖像的保存處理邏輯了腾窝,文件可以正常的保存到后臺(tái)的文件系統(tǒng)里面缀踪,同時(shí)數(shù)據(jù)庫(kù)里面記錄一些必備的信息。
當(dāng)然虹脯,除了用來(lái)處理用戶的肖像圖片驴娃,我們也可以用來(lái)構(gòu)建圖片相冊(cè)的處理操作的,具體界面如下所示循集。
這部分的初始化代碼如下所示:
//初始化fileinput控件(第一次初始化)
$('#file-Portrait').fileinput({
language: 'zh', //設(shè)置語(yǔ)言
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}) 超過(guò)允許的最大數(shù)值{m}唇敞!",
});