本节主要介绍框架的上传组件功能。在本框架中,IE8-9使用uploadify组件上传,其余支持HTML5的浏览器使用HTML5上传,两种上传的API基本一致。

初始化

参数(options)

名称 类型 默认值 描述
uploader string null [必选] D-Url 上传处理URL。
formData object {} [可选] 发送到服务端的额外数据。
fileTypeExts string *.jpg;*.png [可选] 限制上传文件类型,多个以;分隔。
fileObjName string file [可选] 服务端接收到的file域名称。
buttonText string 选择上传文件 [可选] 上传按钮的名称。
auto boolean false [可选] 是否开启自动上传。
multi boolean false [可选] 是否支持一次性选择多个上传文件。
class string btn btn-default 1.4.3+ [可选] 显示上传按钮样式。
hideFileList bool false 1.4.3+ [可选] 是否隐藏上传面板,仅当 auto为true时生效
fileSizeLimit int 204800 [可选] 上传文件大小限制,单位 KB。
onUploadSuccess function(file, data, $element) null [必选] 上传成功时的回调函数,data是服务端返回的JSON数据,$element是触发上传的jQuery对象。
onUploadBefore

function(formData)

1.1.10+

function(formData, $fileElement)

null
[可选] 上传操作前的回调函数,返回false则停止上传动作,返回true则继续上传动作,返回obj则覆盖formData数据
1.1.10+ 回调参数$fileElement为隐藏input文件上传jQuery对象
onUploadComplete function() null [可选] 上传操作完成的回调函数
1.1.10+

function(formData, $fileElement)

onUploadError function() null [可选] 上传操作失败的回调函数
onQueueComplete function() null [可选] 上传队列完成回调函数
dragDrop boolean false [可选] HTML5专用是否开启拖动上传,开启后,将文件拖到按钮上即可上传。
previewImg boolean true [可选] HTML5专用是否预览上传图片。
previewLoadimg string null [可选] HTML5专用载入预览图片前显示的loading图标,previewImg=true时生效。
icon string null [可选] HTML5专用上传按钮的图标。

回调函数的JSON参数

名称 类型 描述
statusCode int 必选。状态码(ok = 200, error = 300, timeout = 301),可以在BJUI.init时配置三个参数的默认值。
message string 可选。提示信息内容。
filename string 可选。上传成功后的文件名称或路径。