Skip to content

基于webuploader配置所加强的框架,使用简单,支持多实例,上传个数限定,预览,删除等,可定制度高。

License

Notifications You must be signed in to change notification settings

joker-pper/WebUploaderSupport

Repository files navigation

WebUploaderSupport

WebUploaderSupport功能包括:

1.文件预览

2.文件删除

3.失败重试

4.加载服务端数据进行展示

5.可重写配置中support的已有的属性及方法进行更改相应的业务逻辑

6.支持文件个数限制(通过beforeFileQueued事件),加入是否为编辑模式,非编辑模式隐藏操作按钮,仅用于展示

7.默认文件不压缩上传,默认只接受图片类型上传

8.支持多实例,使用对应html模板,设置参数便可以进行使用

9.options配置基于webuploader,可以进行其他功能项配置

10.样式不依赖于其他前端ui框架

其他说明:

当前配置下html5模式默认支持拖拽.

webuploader实例仅有一个时粘贴功能才可以正常使用.

flash模式不支持拖拽不支持粘贴功能.

ie不支持粘贴功能.

swf参数请配置正确的路径.

删除文件的url请按需提供.

demo演示

编辑示例

override示例(定制(重写)函数,包含删除逻辑重写等)

展示示例

flash示例

simple示例(不依赖于ui框架)

使用介绍:

    var w5 = new WebUploaderSupport({
        server: "/webuploader-support/webUploader/save?path=webUploader"
        ,swf: '../webuploader/Uploader.swf'  // swf文件所处路径
        ,accept: {
            title: 'Images',
            extensions: 'gif,jpg,jpeg,bmp,png',
            mimeTypes: 'image/!*'
        }
        ,support: {
            fileSize: 3, //文件个数
            multiple: false,  //单选
            uploader: ".uploader.uploader5", //上传区域容器选择器
            thumbnailWidth: 150, //缩略图大小
            thumbnailHeight: 150,

            //加载服务端文件
            serverFiles: [
                {"src":"../images/preview/1.jpg","name":"1.jpg","attrs":{"data-server-file":true,"data-delete-url":""}}
            ],
            
            /**
             * 错误类型处理
             */
            errorTypeHandler: function (type, file) {
                if (type == "Q_TYPE_DENIED") {
                    alert(file.name   "不满足格式要求");
                }
            },

            /**
             * 定义其他事件进行处理
             * @param self
             * @param uploader
             */
            definedEvents: function (self, uploader) {
                uploader.on("startUpload", function () {
                    console.log("startUpload");
                });

                uploader.on("uploadStart", function () {
                    self.uploadStart && self.uploadStart.apply(self, arguments);
                });
            },

            uploadStart: function (file) {
                console.log("uploadStart");
                console.log(file);
            }
        }
    });


api函数:

upload()  上传当前实例的文件
retry()  重试上传当前实例的文件
isInProgress() return boolean  返回当前实例是否正在上传中
editChange(edit)   param edit:boolean 当前实例处于哪种模式(编辑or非编辑)
getCurrentFileSize() 当前文件个数
getSurplusFileSize() 剩余文件个数, -1时不限制
getMaxFileSize() 最大文件个数, -1时不限制

当前默认配置

主要参数配置(除了support外均为webuploader配置参数):
{

    support: { //support核心默认配置
        edit: true,   //是否为编辑模式
        log: false,    //是否打印信息
        multiple: true,  //默认多选
        fileSize: -1,  //文件总个数, -1时无限制
        uploader: ".uploader",  //上传区域容器选择器,用于初始化实例
        thumbnailWidth: 150, //缩略图宽度
        thumbnailHeight: 150,
        fileListMinHeight: 100, //fileList默认最小高度
        serverFiles: []  //服务端文件 当前为 [{name:string, src: string, attrs: {}}]
        serverFileAttrName: "data-server-file",  //标识为服务端文件的属性名称
        deleteServerFileAttrName: "data-delete-url", //删除文件的url
    }
}

var w1 = new WebUploaderSupport(option);
上传成功服务端应返回json: 

{
    "status": boolean, //是否上传成功
    "attrs": {
        "data-server-file": true,  //服务端文件
        "data-delete-url": string,  //删除该服务端文件的url
    } 
}


加载服务端文件列表json: 

[
  {
  "src":"../images/preview/1.jpg",
  "name":"1.jpg",
  "attrs":{
        "data-server-file":true, //作为服务端文件标识
        "data-delete-url":"" //删除该文件的url
    }  //存在的属性将作为item的属性值
  }
]
删除文件返回json: (可重写deleteServerFile及deleteServerFileCallback修改提示效果,参考override.html)
{
    "status": boolean, //是否上传成功
    "content": string //失败时的提示
}

About

基于webuploader配置所加强的框架,使用简单,支持多实例,上传个数限定,预览,删除等,可定制度高。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published