下载地址、API和DOM地址(英语好的小伙伴可以看看)
下载地址:/kartik-v/bootstrap-fileinput
API文档 :/file-input
D E M O:/file-input/demo
做项目用到bootstrap fileinput插件上传文件,在用的过程中,遇到一些问题,所以想着整理一份比较详细的文档,方便自己今后使用,也希望能给大家带来帮助,如有错误,希望大家积极指正,积极交流。
注意:第三部分内容因为存在i标签,某些文字被转换成图标
一、引入文件
<link href="../css/bootstrap.min.css"rel="stylesheet">
<link href="../css/fileinput.css" media="all"rel="stylesheet" type="text/css" />
<scriptsrc="../js/jquery-2.0.3.min.js"></script>
<script src="../js/fileinput.js"type="text/javascript"></script>
<script src="../js/bootstrap.min.js"type="text/javascript"></script>
二、初始化设置
//初始化fileinputinitFileInput();function initFileInput() {$("#uploadImg").fileinput({language: 'zh', //设置语言dropZoneTitle: '可以将图片拖放到这里 …支持多文件上传',uploadUrl: "index.php", //上传的地址uploadExtraData: function(previewId, index) { //该插件可以向您的服务器方法发送附加数据。这可以通过uploadExtraData在键值对中设置为关联数组对象来完成。所以如果你有设置uploadExtraData={id:'kv-1'},在PHP中你可以读取这些数据$_POST['id']var id = $('#id').val();return {seriesId: id};},allowedFileExtensions: ['jpg','png'],//接收的文件后缀uploadAsync: true, //默认异步上传showUpload: true, //是否显示上传按钮showRemove: true, //显示移除按钮showPreview: true, //是否显示预览showCancel:true, //是否显示文件上传取消按钮。默认为true。只有在AJAX上传过程中,才会启用和显示showCaption: true,//是否显示文件标题,默认为truebrowseClass: "btn btn-primary", //文件选择器/浏览按钮的CSS类。默认为btn btn-primarydropZoneEnabled: true,//是否显示拖拽区域minImageWidth: 50, //图片的最小宽度minImageHeight: 50,//图片的最小高度maxImageWidth: 1000,//图片的最大宽度maxImageHeight: 1000,//图片的最大高度maxFileSize: 1024,//单位为kb,如果为0表示不限制文件大小minFileCount: 1, //每次上传允许的最少文件数。如果设置为0,则表示文件数是可选的。默认为0maxFileCount: 0, //每次上传允许的最大文件数。如果设置为0,则表示允许的文件数是无限制的。默认为0previewFileIcon: "<i class='glyphicon glyphicon-king'></i>",//当检测到用于预览的不可读文件类型时,将在每个预览文件缩略图中显示的图标。默认为<i class="glyphicon glyphicon-file"></i> layoutTemplates:{actionUpload:''//去除上传预览缩略图中的上传图片actionZoom:'', //去除上传预览缩略图中的查看详情预览的缩略图标actionDownload:'' //去除上传预览缩略图中的下载图标actionDelete:'', //去除上传预览的缩略图中的删除图标},//对象用于渲染布局的每个部分的模板配置。您可以设置以下模板来控制窗口小部件布局.eg:去除上传图标msgFilesTooMany: "选择上传的文件数量({n}) 超过允许的最大数值{m}!",//字符串,当文件数超过设置的最大计数时显示的消息 maxFileCount。默认为:选择上传的文件数({n})超出了允许的最大限制{m}。请重试您的上传!}).on('filebatchpreupload', function(event, data) { //该方法将在上传之前触发var id = $('#id option:selected').val();if(id == 0){return {message: "请选择", // 验证错误信息在上传前要显示。如果设置了这个设置,插件会在调用时自动中止上传,并将其显示为错误消息。您可以使用此属性来读取文件并执行自己的自定义验证data:{} // any other data to send that can be referred in `filecustomerror`};}});}//fileuploaded此事件仅针对ajax上传触发,并在每个缩略图文件上传完成后触发。此事件仅针对ajax上传并在以下情况下触发:当点击每个预览缩略图中的上传图标并且文件上传成功时,或者当你有 uploadAsync设置为true您已触发批量上传。在这种情况下,fileuploaded每一个人选择的文件被上传成功后,触发事件。var id_str = '';$('#uploadImg').on('fileuploaded', function(event, data, previewId, index) {if(typeof(data.response.id) != 'undefined'){id_str = id_str+data.response.id+',';}});// filebatchuploadcomplete此事件仅在ajax上传和完成同步或异步ajax批量上传后触发。$('#uploadImg').on('filebatchuploadcomplete',function (event,files,extra) {if(id_str.length == 0){layer.msg('上传失败', {icon: 0});//弹框提示return false;}setTimeout(function(){ //执行延时关闭closeSelf();},1000);});
三、Options 说明
四、提示说明设置
五、Method说明
转载地址:/a/1190000018477200