Laravel 中使用jQuery 插件 fileinput 文件上传插件进行异步上传的常规设置
laravel 中有CSRF 保护,fileinput插件配置时,设置_token和_mdthod即可,虽然也可以对指定链接关闭CSRF保护,但个人觉得除了像微信支付、支付宝支付之类的回调请求之外,出于安全考虑,像文件上传这样的还是没有关掉CSRF保护的
var fileOptions = {
"overwriteInitial": false,
"initialCaption": "",
"initialPreviewAsData": true,
"uploadLabel": "上传文件",
"cancelLabel": "取消",
"browseLabel": "浏览",
"msgNoFilesSelected": "未选择文件",
"showRemove": false,
"showUpload": false,
"showPreview": true,
"showUploadedThumbs": true,
"browseOnZoneClick": true,
"dropZoneClickTitle": "或点击这里选择文件<br>文件支持5M以内的PNG、JPG、JPEG、bmp格式<br>",
"deleteExtraData": {
"file_upload": "_file_del_",
"_file_del_": "",
"_token": LA.token,
"_method": "PUT"
},
"deleteUrl": "{{ route('delete_file') }}",
"uploadAsync": false,
"uploadIcon": false,
"uploadUrl": "{{ url('usercenter/sms_batch/file_upload') }}",
"allowedFileExtensions": ["png", "jpg", "jpeg", "bmp"],
"uploadExtraData": {
"_token": LA.token,
"_method": "POST"
},
"initialPreview": [
],
"maxFileCount": 1,
"autoReplace": true,
"minFileCount": 1,
"maxFileSize": 5000, // 5M
"msgSizeTooLarge": "文件 \"{name}\" (<b>{size} KB<\/b>) 超过了允许大小 <b>{maxSize} KB<\/b>.",
"dropZoneTitle": "拖拽文件到这里 …<br>",
"msgFilesTooMany": "选择的上传文件个数 <b>({n})<\/b> 超出最大文件的限制个数 <b>{m}<\/b>.",
"msgFilesTooLess": "你必须选择最少 <b>{n}<\/b> {files} 来上传.",
"msgInvalidFileType": "不正确的类型 \"{name}\". 只支持 \"{types}\" 类型的文件.",
"msgInvalidFileExtension": "不正确的文件扩展名 \"{name}\". 只支持 \"{extensions}\" 的文件扩展名.",
"msgZoomModalHeading": "原图预览",
"required": true,
"msgFileRequired": '至少选择一个文件上传',
"fileActionSettings": {
"showUpload": false,
"showZoom": true,
"removeTitle": "移除文件",
},
};
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> ' |
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">×</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 |
更多事件
方法名 |
描述 |
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 |
在预览框中图片已经完全加载完毕后回调的事件 |