前言：之前的三篇介绍了下bootstrap的一些常用组件，发现博主对这种扁平化的风格有点着迷了。前两天做一个excel导入的功能，前端使用原始的input type='file'这种标签，效果不忍直视，于是博主下定决心要找一个好看的上传组件换掉它。既然bootstrap开源，那么社区肯定有很多关于它的组件，肯定也有这种常见的上传组件吧。经过一番查找，功夫不负有心人，还是被博主找到了这个组件：bootstrap fileinput。在此记录下，就算做个学习笔记，也给需要使用的朋友提供点方便。

Bootstrap组件系列文章：@H_301_4@

一、效果展示

1、原始的input type='file'，简直不忍直视。

2、不做任何装饰的bootstrap fileinput：（bootstrap fileinput初级进化）

3、bootstrap fileinput高级进化：中文化、可拖拽上传、文件扩展名校验（如果不是需要的文件，不让上传）、文件预览

支持拖拽上传

上传中

支持文件后缀名校验

上传文件之前可进行文件预览

4、bootstrap fileinput究极进化：允许同时多线程上传多个文件。

上传中

文件上传完成后

二、代码示例

怎么样？效果如何？如果你觉得效果不错的话，接下来博主就教你如何一步一步去实现它，相信会比官方api入手快。

开源以及API地址：

bootstrap-fileinput源码：

bootstrap-fileinput在线API：

bootstrap-fileinput Demo展示：

1、html页面@H_301_4@

首先引入需要的js和css文件。

当然，既然是bootstrap的组件，它肯定需要bootstrap.js的支持。然后需要jquery的支持。

然后定义input type='file'标签

multiple表示允许同时上传多个文件，class=“file-loading”表示标签的样式。这里很重要，如果class="file"，则中文化不能生效。

2、js初始化@H_301_4@

//初始化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: "",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",index) {}这个方法注册上传完成后的回调事件。也就是后台处理上传的文件之后会进到这个方法里面。经过以上简单的初始化，就可以得到上述示例图片中的效果。

3、后台对应的方法@H_301_4@

还记得在js里面初始化控件方法fileinput()里面有一个参数url吗，这个url对应的值就指示后台对应的处理方法，还是贴出后台的处理方法。（以下为C#示例，如果你的后台语言不是C#，可以定义自己的后台方法）

(); #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处理Excel的逻辑，如果是上传图片等文件，可以使用GDI去处理图片。

4、同时上传多个文件@H_301_4@

同时上传多个文件的时候，前台会发送多个异步的请求到后台，也就是说，当同时上传三个文件的时候，后台的ImportOrder方法会进入三次。这样就能使用多线程同时去处理三个文件。这个博主就不做示例了，有兴趣的朋友可以自行研究下。

三、总结@H_301_4@

关于bootstrap fileinput的基础使用大概就介绍完了，其实就是一个上传的组件，也不存在什么高级用法。重点是把界面做得更加友好，更好的增加用户体验。需要说明的是，组件对IE浏览器的要求比较高，应该最少要IE9以上，还有就是拖拽上传功能在IE浏览器的体验不太好。

如果你的项目也需要文件上传，不妨试试这个，需要测试Demo或者有什么问题可以随时联系博主。当然如果你觉得本文对你有帮助，可以打赏博主，也可以点赞以资鼓励。不管是物资奖励还是精神支持，都是对博主分享精神的肯定，博主一定继续努力。