除了fileinput.min.css和fileinput.min.js外，你必须要加载jquery.min.js和bootstrap.min.css。可选择加入fa.js主题文件来使用 font awesome 图标样式。可选择加入 语言.js，可以把插件翻译成你的语言。
2. 初始化插件 2.1 html加入标签 <input id="files" name="files" type="file" accept="image/jpg,image/png,image/jpeg,image/gif,image/bmp" multiple="multiple"> 2.2 js初始化上传文件标签后台返回的数据在data.response中
$(document).ready(function () { $("#files").fileinput({ language: 'zh', //设置语言 'theme': 'explorer-fas', 'uploadUrl': '#', overwriteInitial: false, initialPreviewAsData: true, allowedFileExtensions: ['jpg', 'png', 'jpeg','gif','bmp'],//接收的文件后缀 maxFileSize: 3*1024, //文件的最大3M maxFileCount: 20, //上传文件的最大数量 enctype: 'multipart/form-data', showUpload: true, //是否显示上传按钮 // uploadAsync: true , //是否异步上传 默认为true uploadExtraData: function() { //额外参数的关键点 var data={ groupId:$('#groupId option:selected').val() }; return data; }, }).on('filebatchpreupload', function(event, data) { //该方法将在上传之前触发 // $.modal.msgWarning('请选择图片分组') // var groupId=$("#groupId").val(); // if(groupId.length==0){ // return { // message: "请选择图片分组", // 验证错误信息在上传前要显示。如果设置了这个设置，插件会在调用时自动中止上传，并将其显示为错误消息。您可以使用此属性来读取文件并执行自己的自定义验证 // data:{} // any other data to send that can be referred in `filecustomerror` // }; // } }).on('fileuploaded', function(event, data, msg) {//异步上传成功结果处理 // console.log("response,ok---"+JSON.parse(data.response)); // Uncaught SyntaxError: Unexpected token o in JSON at position 1 console.log("response,ok---"+JSON.stringify(data.response.msgDetail)); }).on('fileerror', function(event, data, msg) {//异步上传失败结果处理 console.log("response,error---"+JSON.stringify(data.response.msgDetail)); // $("#files").fileinput('refresh'); //刷新组件 }) 3 Ajax上传 3.1 异步上传这是默认模式，也就是说uploadAsync属性设置为true。当上传多个文件时，异步模式允许触发并行调用服务器方法接受每个上传文件。您可以通过设置maxFileCount属性来控制一次允许上传的最大文件数。在异步模式下，预览中每个缩略图的进度被验证和更新。
接收数据（在服务器上）你设置的服务器方法（uploadUrl）从插件接收以下数据:
文件数据:以与form文件输入非常相似的格式将这些数据发送到服务器。例如，在java中，你可以使用参数@RequestParam("files")MultipartFile[] files接受文件数据，files是你的input标签的name属性。如果你没有为input标签设置name属性，则它的名称默认为file_data。
*请注意，多个文件上传需要你为input标签设置multiple属性为true。
额外的数据：该插件可以在你请求服务器方法发送附加数据。这可以通过将uploadExtraData设置为键值对关联数组对象来完成。设置uploadExtraData={key:'value'}
注意
在异步模式下，你会经常在处理ajax上传的服务端接收到单个的文件数据。基本上，这个插件对每个上传的文件都会触发并行的ajax调用方法。你需要相应地编写服务器上传逻辑，以便您始终读取和上传单个文件。同样，在下面的发送数据部分中，你必须返回一个initialPreview，它反映收到的单个文件的数据。
你的服务器方法（uploadUrl）必须返回一个json编码对象数据。在这种情况下，您可以发送这4个信息。
error：string类型，它是整个批量上传的错误消息，并将帮助插件识别文件上传中的错误。例如，来自服务器的响应像{error: ‘You are not allowed to upload such a file.’}这样。注意：插件将自动验证并显示ajax异常错误。
initialPreview：数组，图像文件列表或任何指向你上传文件的HTML标记。你会经常发送此队列中的一行，因为你在异步方式会一直收到上传的单个文件。如果设置了此属性，插件会在每个文件上传成功后动态地在预览内容中替换文件。这个配置类似于initialPreview选项设置。例如：
initialPreviewConfig：数组，用于标识initialPreview条目（即initialPreview的一部分）中每个文件标记的属性的配置。你会始终发送这个队列中一行，因为你始终以异步方式收到上传的一个文件。如果设置了此属性，插件会在每个文件上传成功后自动在预览内容中替换文件。这个配置类似于initialPreviewConfig选项设置。例如：initialPreviewConfig ：
[ { 标题:'desert.jpg' ， width:'120px' ， url:'http://localhost/avatar/delete' ，//服务器删除操作 关键:100 ， extra:{id:100} }]initialPreviewThumbTags：数组，每个初始预览缩略图相对应的替换标签对象数组。通过initialPreview设置的初始预览缩略图会读取此配置为替换标签。
/更改缩略图页脚模板//设置初始预览模板标签initialPreviewThumbTags ：[ { '{CUSTOM_TAG_NEW}':'', '{CUSTOM_TAG_INIT}':'<span class = 'custom-css'>CUSTOM MARKUP</span> ' }];append：boolean类型，如果你已经在INIT中设置了initialPreview是否将内容插入initialPreview。如果未设置，则默认为true。如果设置false，插件将覆盖initialPreview内容。
重要你必须从服务器发送有效的JSON响应，否则上传过程将失败。即使您没有遇到任何错误，您至少必须从服务器发送一个空的JSON对象{}。
要捕获并显示验证错误，你的JSON响应数据必须包含该error键，其值将是要显示的错误HTML标记。如上所述那样设置。
你还可以使用JSON响应发送附加的密钥或数据，以便使用诸如fileuploaded此类的事件对高级案例进行处理
3.2 同步上传在此模式下，uploadAsync属性设置为false。它只会触发一次批量上传到服务器的方法，并将文件以对象数组的方式从客户端发送到服务器。尽管在此模式下，你可以通过设置maxFileCount属性来控制一次允许上传的最大文件数。然而，在同步模式下，进度只会是对于整体水平的一个标量。预览中每个缩略图的进度未被精确计算和更新。但是，该插件为你提供了识别每个文件上传错误的方法。
接收数据和异步上传数据格式相同
发送数据在同步模式下，uploadUrl必须发送json编码对象数据作为响应。在这种情况下，你需要发送这5条信息。
error：字符串类型，它是整个批量上传的错误消息，并将帮助插件识别文件上传中的错误。
errorkeys：数组类型，已经出错的文件的键值（接收的文件数据的基于零的索引）。根据这些数据，插件会自动设置缩略图和每个预览文件的错误。
initialPreview: 数组类型，图像文件列表或任何指向你上传文件的HTML标记。如果设置了此属性，插件会在上传成功后自动在预览内容中替换文件。这个配置类似于initialPreview选项设置。
initialPreviewConfig：数组类型，用于标识initialPreview条目中每个文件标记（即作为initialPreview的一部分进行设置）的属性的配置。如果设置了此属性，插件会在上传成功后自动在预览内容中替换文件。这个配置类似于initialPreviewConfig选项设置。
initialPreviewThumbTags：数组类型，对应于每个初始预览缩略图中替换标签的对象数组。通过设置initialPreview的初始预览缩略图将读取此配置以替换标签
append：布尔类型，如果你在初始化时设置了initialPreview，是否将新的内容附加到initialPreview中。如果未设置，则默认为true。如果设置为false，插件将覆盖initialPreview内容。
例如，来自服务器的响应将发送{error: ‘You have faced errors in 4 files.’, errorkeys: [0, 3, 4, 5]}作为响应。注意：插件将自动验证并显示ajax异常错误。
你必须从服务器发送有效的JSON响应，否则上传过程将失败。即使您没有遇到任何错误，您至少必须从服务器发送一个空的JSON对象。
要捕获并显示验证错误，你的JSON响应数据必须包含该error键，其值将是要显示的错误HTML标记。
filebatchpreupload可用于上传前的校验
此事件仅对于ajax上传的上传按钮被单击之后且批量上传开始之前才会触发（同步和异步上传）
fileuploaded异步上传成功结果处理
fileuploaded此事件仅针对ajax上传触发，并在每个缩略图文件上传完成后触发。此事件仅针对ajax上传并在以下情况下触发：当点击每个预览缩略图中的上传图标并且文件上传成功时，或者jmdzx有 uploadAsync设置为true您已触发批量上传。在这种情况下，fileuploaded每一个人选择的文件被上传成功后，触发事件。
fileerror异步上传错误结果处理
当上传文件客户端验证错误时，会触发此事件。
filebatchuploadsuccess
此事件仅在ajax上传且文件批量上传成功之后触发
filebatchuploadcomplete
此事件仅对于ajax上传且完成同步或异步ajax批量上传后触发。
使用:
$('#uploadfile').on('fileerror', function(event, data, msg) {});其他事件参考:http://www.bootstrap-fileinput.com/events.html
5 配置项常用配置项已经在上面举例中提到,其他配置项参考以下链接
参考:http://www.bootstrap-fileinput.com/events.html