bootstrap fileinput api

bootstrap fileinput apiBootstrapFileInput中文API整理

大家好,又见面了,我是你们的朋友全栈君。

一、    引入文件

<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>

二、    初始化设置:

$(“#uploadfile”).fileinput({

                language: ‘zh’, //设置语言

                uploadUrl:”http://127.0.0.1/testDemo/fileupload/upload.do”, //上传的地址

               allowedFileExtensions: [‘jpg’, ‘gif’, ‘png’],//接收的文件后缀

               //uploadExtraData:{“id”: 1, “fileName”:’123.mp3′},

                uploadAsync: true, //默认异步上传

                showUpload:true, //是否显示上传按钮

                showRemove :true, //显示移除按钮

                showPreview :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: “<iclass=’glyphicon glyphicon-king’></i>”,

               msgFilesTooMany: “选择上传的文件数量({n}) 超过允许的最大数值{m}!”,

           }).on(“fileuploaded”, function (event, data, previewId, index){

                 

});

三、    Options 说明:

属性名

属性类型

描述说明

默认值

language

String

多语言设置,使用时需提前引入\locales文件夹下对应的语言文件,中文zh,引入语言文件必须放在fileinput.js之后

‘en’

showCaption

Boolean

是否显示被选文件的简介

true

showBrowse

Boolean

是否显示浏览按钮

true

showPreview

Boolean

是否显示预览区域

true

showRemove

Boolean

是否显示移除按钮

true,

showUpload

Boolean

是否显示上传按钮

true,

showCancel

Boolean

是否显示取消按钮

true,

showClose:

Boolean

是否显示关闭按钮

true

showUploadedThumbs

Boolean

 

true

browseOnZoneClick

Boolean

 

false

autoReplace

Boolean

是否自动替换当前图片,设置为true时,再次选择文件,会将当前的文件替换掉。

false

generateFileId

Object

 

null

previewClass

String

添加预览按钮的类属性

‘’

captionClass

String

 

‘’

frameClass

String

 

‘krajee-default’

mainClass

String

 

‘file-caption-main’

mainTemplate

Object

 

null

purifyHtml

Boolean

 

true

fileSizeGetter

Object

 

null

initialCaption

String

 

”

initialPreview

Array/Object

 

[]

initialPreviewDelimiter

String

 

‘*$$*’

initialPreviewAsData

Boolean

 

false

initialPreviewFileType

String

 

‘image’

initialPreviewConfig

Array/Object

 

[]

initialPreviewThumbTags

Array/Object

 

[]

previewThumbTags

Object

 

{}

initialPreviewShowDelete

Boolean

 

true

removeFromPreviewOnError

Boolean

 

false

deleteUrl

String

删除图片时的请求路径

”

deleteExtraData

Object

删除图片时额外传入的参数

{}

overwriteInitial

Boolean

 

true

previewZoomButtonIcons

Object

 

{

prev: ‘<i class=”glyphicon glyphicon-triangle-left”></i>’,

  next: ‘<i class=”glyphicon glyphicon-triangle-right”></i>’,

  toggleheader: ‘<i class=”glyphicon glyphicon-resize-vertical”></i>’,

  fullscreen: ‘<i class=”glyphicon glyphicon-fullscreen”></i>’,

  borderless: ‘<i class=”glyphicon glyphicon-resize-full”></i>’,

  close: ‘<i class=”glyphicon glyphicon-remove”></i>’

},

previewZoomButtonClasses

Object

 

{

  prev: ‘btn btn-navigate’,

  next: ‘btn btn-navigate’,

  toggleheader: ‘btn btn-default btn-header-toggle’,

  fullscreen: ‘btn btn-default’,

  borderless: ‘btn btn-default’,

  close: ‘btn btn-default’

},

preferIconicPreview

Boolrean

 

false

preferIconicZoomPreview

Boolrean

 

false

allowedPreviewTypes

undefined

 

undefined

allowedPreviewMimeTypes

Object

 

null

allowedFileTypes

Object

接收的文件后缀,如[‘jpg’, ‘gif’, ‘png’],不填将不限制上传文件后缀类型

null

allowedFileExtensions

Object

 

null

defaultPreviewContent

Object

 

null

customLayoutTags

Object

 

{}

customPreviewTags

Object

 

{}

previewFileIcon

String

 

‘<i class=”glyphicon glyphicon-file”></i>’

previewFileIconClass

String

 

‘file-other-icon’

previewFileIconSettings

Object

 

{}

previewFileExtSettings

Object

 

{}

buttonLabelClass

String

 

‘hidden-xs’

browseIcon

String

 

‘<i class=”glyphicon glyphicon-folder-open”></i>&nbsp;’

browseClass

String

 

‘btn btn-primary’

removeIcon

String

 

‘<i class=”glyphicon glyphicon-trash”></i>’

removeClass

String

 

‘btn btn-default’

cancelIcon

String

 

‘<i class=”glyphicon glyphicon-ban-circle”></i>’

cancelClass

String

 

‘btn btn-default’

uploadIcon

String

 

‘<i class=”glyphicon glyphicon-upload”></i>’

uploadClass

String

 

‘btn btn-default’

uploadUrl

String

上传文件路径

null

uploadAsync

boolean

是否为异步上传

true

uploadExtraData

 

上传文件时额外传递的参数设置

{}

zoomModalHeight

number

 

480

minImageWidth

String

图片的最小宽度

null

minImageHeight

String

图片的最小高度

null

maxImageWidth

String

图片的最大宽度

null

maxImageHeight

String

图片的最大高度

null

resizeImage

boolean

 

false

resizePreference

String

 

‘width’

resizeQuality

number

 

0.92

resizeDefaultImageType

String

 

‘image/jpeg’

minFileSize

number

单位为kb,上传文件的最小大小值

0

maxFileSize

number

单位为kb,如果为0表示不限制文件大小

0

resizeDefaultImageType

number

 

25600(25MB)

minFileCount

number

表示同时最小上传的文件个数

0

maxFileCount

number

表示允许同时上传的最大文件个数

0

validateInitialCount

boolean

 

false

msgValidationErrorClass

String

 

‘text-danger’

msgValidationErrorIcon

String

 

‘<i class=”glyphicon glyphicon-exclamation-sign”></i> ‘

msgErrorClass

String

 

‘file-error-message’

progressThumbClass

String

 

“progress-bar progress-bar-success progress-bar-striped active”

rogressClass

String

 

“progress-bar progress-bar-success progress-bar-striped active”

progressCompleteClass

String

 

“progress-bar progress-bar-success”

progressErrorClass

String

 

“progress-bar progress-bar-danger”

progressUploadThreshold

number

 

99

previewFileType

String

预览文件类型,内置[‘image’, ‘html’, ‘text’, ‘video’, ‘audio’, ‘flash’, ‘object’,‘other‘]等格式

‘image’

elCaptionContainer

String

 

null

elCaptionText

String

设置标题栏提示信息

null

elPreviewContainer

String

 

null

elPreviewImage

String

 

null

elPreviewStatus

String

 

null

elErrorContainer

String

 

null

errorCloseButton

String

 

‘<span class=”close kv-error-close”>&times;</span>’

slugCallback

String

 

null

dropZoneEnabled

boolean

是否显示拖拽区域

true

dropZoneTitleClass

String

拖拽区域类属性设置

‘file-drop-zone-title’

fileActionSettings

Object

 

{}

otherActionButtons

String

 

”

textEncoding

String

编码设置

‘UTF-8’

ajaxSettings

Object

 

{}

ajaxDeleteSettings

Object

 

{}

showAjaxErrorDetails

boolean

 

true

五、    Method说明:

方法名

参数

描述

fileerror

 

异步上传错误结果处理

$(‘#uploadfile’).on(‘fileerror’, function(event, data, msg) {

   

});

fileuploaded

 

异步上传成功结果处理

$(“#uploadfile”).on(“fileuploaded”, function (event, data, previewId, index) {

  

})

filebatchuploaderror

 

同步上传错误结果处理

$(‘#uploadfile’).on(‘filebatchuploaderror’, function(event, data, msg) {

     

});

filebatchuploadsuccess

 

同步上传成功结果处理

$(‘#uploadfile’).on(‘filepreupload’, function(event, data, previewId, index) {

       

});

filebatchselected

 

选择文件后处理事件

$(“#fileinput”).on(“filebatchselected”, function(event, files) {

});

upload

 

文件上传方法

$(“#fileinput”).fileinput(“upload”);

fileuploaded

 

上传成功后处理方法

$(“#fileinput”).on("fileuploaded", function(event, data, previewId, index) {

});

filereset

 

 

fileclear

 

点击浏览框右上角X 清空文件前响应事件

$(“#fileinput”).on(“fileclear”,function(event, data, msg){

});

filecleared

 

点击浏览框右上角X 清空文件后响应事件

$(“#fileinput”).on(“filecleared”,function(event, data, msg){

});

fileimageuploaded

 

在预览框中图片已经完全加载完毕后回调的事件

 

六、    常见错误:

 (1)   当点击上传后,报错,提示你必须选择最少X个文件上传。

错误原因:html中input标签元素属性:data-min-file-count=”2″ 设置为X个文件,限制上传文件数。

备注:图片上传比例判断
 $(“#imgFile”).fileinput({}).on(‘fileimageloaded’,function(event,previewId){

        var img = $(‘#’+previewId).find(‘img’)[0];
        if (img.naturalWidth!=img.naturalHeight) {

        alert(‘图片尺寸必须1:1’);
        image_check = true;
        $(‘.fileinput-remove’).click();
        }else{

        image_check = false;
        $(‘.fileinput-upload’).show();
         }

})

$(“#imgFile”).fileinput({

            language : ‘zh’,
            //uploadUrl:’../../module/uploadMod/index.php?c=upd&a=fileInputUpload&dir=image’,
            showUpload: false, //是否显示上传按钮
            showCaption: false,//是否显示输入框
            showRemove: true,//是否显示删除按钮
            dropZoneEnabled: false,
            showClose:false,
            showDrag: false,
            //initialPreviewShowDelete:false,
            browseClass: “btn btn-primary”,
            allowedFileExtensions: [‘jpg’, ‘png’, ‘gif’],
            previewFileIcon: “<i class=’glyphicon glyphicon-king’></i>”,
            overwriteInitial: false,
            initialPreviewAsData: true,
            //initialPreview: [],
            //initialPreviewConfig:images_arr_info,
            fileActionSettings:{

                showZoom: true,
                showDrag: false,
                showRemove:false,
                showUpload:false
            }

        }).on(“fileuploaded”, function(event, data,previewId,index) {

            var data = data.response;
            image = JSON.stringify(data);

            $(“#topImg”).hide().parent().hide();
            $(‘.fileinput-upload’).hide();
        }).on(‘filebatchselected’, function(event, files) {

            if(files.length<=0){

                $(‘.fileinput-upload-button’).hide();
            }else{

                $(‘.fileinput-upload-button’).show();
            }
        }).on(‘fileimageloaded’,function(event,previewId){

        var img = $(‘#’+previewId).find(‘img’)[0];
        if (img.naturalWidth!=img.naturalHeight) {

        alert(‘图片尺寸必须1:1’);
        image_check = true;
        $(‘.fileinput-remove’).click();
        }else{

        image_check = false;
        $(‘.fileinput-upload’).show();
        }
        });
        
        $(‘.fileinput-remove’).on(‘click’,function () {

            image = ”;
            $(“#topImg”).val(”).show().parent().show();
            $(‘.fileinput-upload’).hide();
        })

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/142041.html原文链接:https://javaforall.net

赞 (0)
全栈程序员-站长的头像全栈程序员-站长


相关推荐

  • 从零开始学android<android开发环境的搭建.一.>[通俗易懂]

    从零开始学android<android开发环境的搭建.一.>[通俗易懂]我是一名无名学校的和计算机专业有一点关系的大学僧,当然还是比较喜欢计算机   游戏的……平时喜欢编程,喜欢把自己的思路和想法变为现实,爱琢磨,就这样开始学习Java了,然后就不知道怎么地开始看android这块了,当然我也是刚刚开始学习,我会在这里和大家分享我的学习经验和问题。…………………………………………………一点也不华丽得分割线…………………………………………………

    2022年6月21日
  • 瓦片地图拼接_开源瓦片地图

    瓦片地图拼接_开源瓦片地图瓦片地图(TiledMap)瓦片地图(TileMap)不但生成简单,并且可以灵活的用于Cocos2d-x引擎。不论你的游戏是角色扮演游戏,平台动作游戏或仿打砖块游戏,这些游戏地图可以使用开源的瓦片地图编辑器TiledMapEditor生成并保存为TMX文件格式,被Cocos2d-x支持。TMX瓦片地图格式Cocos2d支持被Tiled创建的地图文件(TMX)。Tiled的2个版本…

    2022年10月22日
  • CDMA是什么意思_GPRS/CDMA

    CDMA是什么意思_GPRS/CDMA(1)2G网络:GSM(GlobalSystemForMobileCommunications)全球移动通信系统,GSM数字移动通信系统史源于欧洲,是欧洲电信标准组织制定的数字移动通信标准。它的空中接口采用时分多址技术。它是全球应用最广泛的移动电话标准。GSM较之它以前的标准最大的不同是它的信令和语音信道都是数字式的,因此GSM被看作是第二代(2G)移动电话系统。GSM数字…

    2022年9月27日
  • 快速搭建个人博客——保姆级教程「建议收藏」

    文章目录序言本地网站开发工具WebStormVscode框架Hexo(强烈推荐)WordPress本地环境gitnode.jsHexo安装初始化主题样式Butterfly应用正式上线图床Butterfly配置GitHubPages配置服务器选购攻略阿里云学生专享活动专享腾讯云学生专享活动专享域名购买DNS解析添加域名添加解析记录服务器购买部署密码设定远程连接git配置安装NginxHexo配置修改备案ICP联网备案序言偶然间,看到某乎上高赞的一个问题:怎么证明下计算机专业学生的能力?问题下面呢,也是有

    2022年4月15日
  • 百度搜索引擎中的快照及快照更新机制「建议收藏」

    百度搜索引擎中的快照及快照更新机制「建议收藏」百度搜索引擎中的快照及快照更新机制   1、什么是百度快照?  如果无法打开某个搜索结果,或者打开速度特别慢,该怎么办?“百度快照”能帮您解决问题。每个被收录的网页,在百度上都存有一个纯文本的备份,称为“百度快照”。百度速度较快,您可以通过“快照”快速浏览页面内容。不过,百度只保留文本内容,所以,那些图片、音乐等非文本信息,快照页面还是直接从原网页调用。如果您无法连接原网页,那么…

    2022年9月28日
  • C#验证码的实现_验证码怎么实现

    C#验证码的实现_验证码怎么实现一.编程思想(1).验证码由四位随机数字或者字母组成,此时就要考虑怎么获取随机数(2).各个字符之间怎么进行连接(3).当点击更换时会重新生成四位随机数(4).四位字符的显示二.代码的实现(1).引入伪随机数生成器Random,生成随机数实例化Random:Randomp=newRandom();//表示伪随机数生成器Randomp=newRandom();……

    2022年9月10日

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号