# uploader **Repository Path**: mirrors/uploader ## Basic Information - **Project Name**: uploader - **Description**: Uploader是非常强大的异步文件上传组件，支持ajax、iframe、flash三套方案，实现浏览器的全兼容，调用非常简单，内置多套主题支持 和常用插件，比如验证、图片预览、进 - **Primary Language**: JavaScript - **License**: Not specified - **Default Branch**: master - **Homepage**: https://www.oschina.net/p/uploader - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2020-06-11 - **Last Updated**: 2023-09-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Uploader 异步文件上传组件，支持ajax、iframe、flash三种上传方案，自带多套主题，并允许用户自定义主题和插件，拥有相当不错的扩展性。 - 版本：1.5.4（基于kissy1.4.2） - 作者：明河、紫英、飞绿 - uploader入门指南 - 一个简单的demo ## 组件变更 ### V1.5.4 change [!] #130 修正filter无效的bug [!] #130 filter接受的数据改成json对象 [!] #130 增加timeout配置 ### V1.5.3 change [!] #130 修正IE8按钮上文案的bug [!] #131 修正max校验异常的bug ### V1.5.2 change [+] #117 跨终端上传插件和主题实现 [!] #114 修正与kissy1.4无法兼容的bug [!] #116 修正data.set()抛异常的bug ### V1.5 change [!] #46 使用grunt打包 [!] #52 重写UploadType类，继承Promise [!] 进度条插件动画位移bug修复 [!] 重构ajax上传方式 [!] #72 Queue getFile()方法优化 [!] 将input append到容器，而不是重新创建一个 [!] #95 修复IE图片预览的bug [!] 图片放大器插件重构 [+] #49 支持分段上传实现 [+] #65 AjaxType增加timeout配置 [+] #77 基于kissy1.3.1 [+] #76 跨域上传支持 [+] UrlsInput增加useName配置 [+] #62 支持label触发文件选择 [+] #93 支持粘贴上传 [+] 新增grayUploader主题 [-] #67 不支持kissy1.2 [-] 去掉旧的二手主题和mutilImageUploader主题 [-] 删除_oldInput ### V1.4.5 change [+] 增加plugins模块，用于简化插件引用 [+] 增加xhrFields [+] 新增AliUploader类，阿里应用可以使用默认接口 ### V1.4.4 change [!] 新增grayUploader主题 ### V1.4.3 change [!] #44 多选上传时，max存在bug，感谢子虎反馈 ### V1.4.2 change [!] #38 图片裁剪插件报错 [!] #40 refundUploader使用的时候报错 [!] #41 删除队列图片时，隐藏域表单值没有被删 [!] #43 添加默认数据不该触发验证 ### V1.4.1 change [!] #33 修正IE下渲染默认图片，抛异常的bug [!] #25 IE下自动禁用多选上传（iframe） [!] #23修正图片预览在IE下的bug ### V1.4.0 change [!] 基于kissy1.3，内部结构和接口继承于rich-base [!] 只有Uploader类，即只有uploader/index模块，通过主题控制是否是图片上传还是文件上传 [!] 重构简化主题设计，进度条的处理移到ProBars插件，插件使用简化，去掉状态层概念，全部使用事件监听 [!] multiple默认为false，禁用多选 [!] 默认上传方式改成["ajax","iframe"] [!] 服务器返回数据结构简化，不再有data字段 [!] 可以不指定queue目标（该目标与主题绑定） [!] restore方法移动到urlsInput [!] IE下图片预览优化 [!] 进度条插件重构 [!] 修正_errorHandler报错的bug（daogouUploader主题） [!] 去掉theme.js状态层的log提示 [!] 将auth模块移到plugins下，变成插件 [!] singleImageUploader当已经有图片存在时替换图片 [!] singleImageUploader去掉max限制 [!] 重构UrlsInput，变成uploader的插件，去掉create方法，不会自动创建urlsInput [!] 修正queue的clear方法，没有把li节点去掉的bug [+] uploader增加queue的add和remove事件 [+] 新增use()方法用于引入插件 [+] 新增theme()方法，初始化主题 [+] 增加图片尺寸控制验证 [+] 新增themeRender事件 [+] 主题增加从html拉取模版的功能 [+] 主题增加extend配置从外部快速覆盖主题监听器的功能 [+] 主题去掉插件加载，增加use配置，引入uploader插件 [+] restore渲染默认数据的动作移动到主题 [+] 新增ImageZoom插件 [-] 去掉data-config配置支持 [-] 去掉不使用主题情况支持 [-] 去掉theme-config配置支持 [-] 去掉serviceConfig配置项 [-] 去掉init和render事件 ### V1.3.0 change [+] 新增ImageUploader专用图片上传组件 [+] #31 restore方法重构 [+] ImageUploader可以使用优化的伪属性传参方式 [+] Uploader新增action参数，用于配置服务器端路径 [+] 新增filter参数，用于手动过滤服务器端不合法数据 [+] 新增refundUploader主题 [+] 新增daogou文件上传主题 [+] 新增singleImageUploader主题 [+] 新增testRequired [+] 自动将unicode转成中文 [+] 可以直接通过uploader的实例，来获取验证配置 [+] 给uploader增加testMax和testRequired方法 [+] #25可以通过data-valid来配置验证消息 [!] 1.2的imageUploader主题变成loveUploader [!] 重构imageUploader主题，让主题更具通用性 [!] 优化图片预览插件，支持多选图片预览（IE下不支持图片预览） [!] 修正flash下返回的服务器端编码乱码的问题 [!] 验证规则require改成required，为了和html中的required属性保持统一 [!] auth的error事件对象增加index [!] 不再建议操作auth的实例 [!] #27修正imageUploader主题打印出错消息时，不隐藏mask层 [!] 修正当没有设置max时，脚本设置无效的问题 [-] Uploader弃用restoreHook [-] Auth弃用require [-] Uploader弃用serverConfig [-] Uploader弃用restore事件 [!] 修正iframe remove form时的报错问题 [!] 修正data传递失败的问题 ### V1.2.7 change 修正最大文件字节数统计错误的bug #92 增加restore事件 #93 当达到最大允许上传数时，删除一张图片，再传一张，testMax验证失效，没有禁用按钮 ### V1.2.6 change error事件数据增加status和file 优化imageUploader主题 前端验证，事件参数增加result:{},与uploader的error事件保持一致 #85 uploader增加data属性，用于动态配置post到服务器端的数据 #84 uploader增加multipleLen参数控制多选图片最大张数 #69 修正flash上传隐藏按钮后无法上传 #75 修正restore数据时不触发auth验证的bug #76 auth的事件集成到uploader的error事件中 #80 修正在chrome19下文件多选时首次可以多选，之后就只能单选的bug #81 修正开启拖拽后，禁用按钮时，没有移除拖拽区域的bug #82 修正默认主题状态层有进度条时删除入口跑到第二行的bug ### V1.2.3 change #69 修正flash上传隐藏按钮后无法上传 修正flash文件无法过滤 imageUploader主题增加isMaxHideBtn配置 ### V1.2.2 change #68 修正iframe上传按钮在IE下无法点击的bug #67 修正flash上传，安全漏洞问题的bug #66 修正restore方法时没有触发auth的max验证的bug post上传方式到服务器端(type) 解析json前先清空空格 demo中心优化 ### V1.2.1 change #57 修正小版本firefox出现按钮无法点击的bug #58 修正flash上传存在无法找到文件域的bug #59 修正初始按钮过大 #35 修正鼠标手型bug #60 修正iframe上传方式在不存在data的情况下会报错的bug #61 修正queueTarget不存在时会有bug的bug #61 uploader增加swfSize参数，用于强制设置flash大小 #65 flash多个实例的情况下会出现冲突的bug #64 图片上传进度条存在bug ### V1.2.0 change #43 修正取消操作无用的bug #44 修正IE6/IE7会报缺少）的错误的bug #49 修正IE6下可点击区域过小无法调整的bug #51 修正进度条bug 图片预览在多选下存在bug，先予以禁用 #26 type:auto，改成等价于["ajax","flash","iframe"]，除非是特别需求，不推荐修改type #27 IE下优先使用flash，解决多选问题 #50 增加themeConfig、authConfig参数 #50 button的配置集成到uploader/base.js，uploader增加multiple和disabled二个属性， 非特殊需求请勿直接修改button实例的属性，去掉data-button-config支持 #52 修正type设置有flash，却不实例化flash按钮的bug 优化主题样式加载时机（之前按钮的大小设置有问题） Filedrop增加isSupport属性 ### V1.1.4 change 修正进度换算bug 修正不加载插件不执行回调bug 修正不使用主题的情况下，监听init事件无效的bug 修正多个iframe上传的bug 修正imageUploader主题删除图片后无法显示按钮的bug 修正不使用插件，对应插件没做容错处理的bug ### V1.1.3 change 修正restore方法无法处理服务器端的bug 支持不使用内置主题的情况，设置theme:'' queue初始化过程移到RenderUploader 增加个不使用内置主题的demo 修正ajax上传，修改了传给服务器端的参数,serverConfig，但上传时依旧post旧的数据 淘宝二手市场主题重新可用 去掉isUseCss多余的判断 ### V1.1.2 change 优化Queue类，Queue不再包含dom操作 Queue配置项，增加fnAdd（添加文件后执行的回调函数） 删除与DOM相关的配置项和属性 Queue的dom操作移到theme处理，用户可以自由覆盖控制li元素的显隐，以及是否输出DOM结构 Theme增加plugins参数，组件自动加载插件 修正主题引用路径的bug 默认开启文件多选（多选bug已经修复） 优化默认主题的样式 修正imageUploader，默认有数据的情况下统计失败的问题 ### V1.1 change 重构主题基类，让主题制作更简单 去掉难以理解的Status类，状态变更集成到Theme 增加Theme主题基类，主题不再继承DefaultTheme，导致会加载多余样式 新增imageUploader主题，先去除不可用的grayQueue和lineQueue主题 增加拖拽上传插件 增加拖拽主题 修正多处兼容性bug 主题路径，如果使用的是组件内置主题，只要传递主题名就好 修正ajax多选上传，只上传一个图片的bug 优化拖拽上传插件，支持点击上传 修正验证失败依旧上传的bug 重写restore方法，可以从页面抓取文件数据，而不是从urlsInput 修正图片预览报错bug