JavaScript 上传插件plupload

最新推荐文章于 2024-08-22 08:14:49 发布
最新推荐文章于 2024-08-22 08:14:49 发布
阅读量817 收藏 3
点赞数
分类专栏： JavaScript 文章标签： plupload
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/boonya/article/details/103427137
版权

官网：https://www.plupload.com/

示例：http://chaping.github.io/plupload/demo/

下载：https://www.plupload.com/download

http://www.phpin.net/tools/plupload/

Plupload上传插件中文帮助文档

配置参数

实例化一个plupload对象时，也就是 new plupload.Uploader()，需要传入一个对象作为配置参数。后面内容中出现的plupload实例均是指new plupload.Uploader()得到的实例对象

属性类型默认值描述
browse_buttonString / DOM 触发文件选择对话框的DOM元素，当点击该元素后便后弹出文件选择对话框。该值可以是DOM元素对象本身，也可以是该DOM元素的id
urlString 服务器端接收和处理上传文件的脚本地址，可以是相对路径(相对于当前调用Plupload的文档)，也可以是绝对路径
filtersObject{ }可以使用该参数来限制上传文件的类型，大小等，该参数以对象的形式传入，它包括三个属性：mime_types：用来限定上传文件的类型，为一个数组，该数组的每个元素又是一个对象，该对象有title和extensions两个属性，title为该过滤器的名称，extensions为文件扩展名，有多个时用逗号隔开。该属性默认为一个空数组，即不做限制。

 

max_file_size：用来限定上传文件的大小，如果文件体积超过了该值，则不能被选取。值可以为一个数字，单位为b,也可以是一个字符串，由数字和单位组成，如’200kb’

prevent_duplicates：是否允许选取重复的文件，为true时表示不允许，为false时表示允许，默认为false。如果两个文件的文件名和大小都相同，则会被认为是重复的文件

filters完整的配置示例如下(当然也可以只配置其中的某一项)：

filters: {
mime_types : [ //只允许上传图片和zip文件
{ title : "Image files", extensions : "jpg,gif,png" }, 
{ title : "Zip files", extensions : "zip" }
],
max_file_size : '400kb', //最大只能上传400kb的文件
prevent_duplicates : true //不允许选取重复文件
}
headersObject 设置上传时的自定义头信息，以键/值对的形式传入，键代表头信息属性名，键代表属性值。html4上传方式不支持设置该属性。
multipartBooleantrue为true时将以multipart/form-data的形式来上传文件，为false 时则以二进制的格式来上传文件。html4上传方式不支持以二进制格式来上传文件，在flash上传方式中，二进制上传也有点问题。并且二进制格式上传还 需要在服务器端做特殊的处理。一般我们用multipart/form-data的形式来上传文件就足够了。
multipart_paramsObject 上传时的附加参数，以键/值对的形式传入，服务器端可是使用$_POST来获取这些参数(以php为例)。比如：

 

multipart_params: {
one: '1',
two: '2',
three: { //值还可以是一个字面量对象
a: '4',
b: '5'
},
four: ['6', '7', '8']  //也可以是一个数组
}
max_retriesNumber0当发生plupload.HTTP_ERROR错误时的重试次数，为0时表示不重试
chunk_sizeNumber/String0分片上传文件时，每片文件被切割成的大小，为数字时单位为字节。也可以使用一个带单位的字符串，如"200kb"。当该值为0时表示不使用分片上传功能
resizeObject 可以使用该参数对将要上传的图片进行压缩，该参数是一个对象，里面包括5个属性：width：指定压缩后图片的宽度，如果没有设置该属性则默认为原始图片的宽度

 

height：指定压缩后图片的高度，如果没有设置该属性则默认为原始图片的高度

crop：是否裁剪图片

quality：压缩后图片的质量，只对jpg格式的图片有效，默认为90。quality可以跟width和height一起使用，但也可以单独使用，单独使用时，压缩后图片的宽高不会变化，但由于质量降低了，所以体积也会变小

preserve_headers：压缩后是否保留图片的元数据，true为保留，false为不保留,默认为true。删除图片的元数据能使图片的体积减小一点点

resize参数的配置示例如下：

resize: {
width: 100,
height: 100,
crop: true,
quality: 60,
preserve_headers: false
}
drop_elementDOM/String/Array 指定了使用拖拽方式来选择上传文件时的拖拽区域，即可以把文件拖拽到这个区域的方式来选择文件。该参数的值可以为一个DOM元素的id,也可是 DOM元素本身，还可以是一个包括多个DOM元素的数组。如果不设置该参数则拖拽上传功能不可用。目前只有html5上传方式才支持拖拽上传。
multi_selectionBooleantrue是否可以在文件浏览对话框中选择多个文件，true为可以，false为不可以。默认true，即可以选择多个文件。需要注意的是，在某些不支持 多选文件的环境中，默认值是false。比如在ios7的safari浏览器中，由于存在bug，造成不能多选文件。当然，在html4上传方式中，也是 无法多选文件的。
required_featuresMix 可以使用该参数来设置你必须需要的一些功能特征，Plupload会根据你的设置来选择合适的上传方式。因为，不同的上传方式，支持的功能是不同 的，比如拖拽上传只有html5上传方式支持，图片压缩则只有html5,flash,silverlight上传方式支持。该参数的值是一个混合类型， 可以是一个以逗号分隔的字符串，
unique_namesBooleanfalse当值为true时会为每个上传的文件生成一个唯一的文件名，并作为额外的参数post到服务器端，参数明为name,值为生成的文件名。
runtimesStringhtml5,flash,
silverlight,
html4		用来指定上传方式，指定多个上传方式请使用逗号隔开。一般情况下，你不需要配置该参数，因为Plupload默认会根据你的其他的参数配置来选择 最合适的上传方式。如果没有特殊要求的话，Plupload会首先选择html5上传方式，如果浏览器不支持html5，则会使用flash或 silverlight，如果前面两者也都不支持，则会使用最传统的html4上传方式。如果你想指定使用某个上传方式，或改变上传方式的优先顺序，则你 可以配置该参数。
file_data_nameStringfile指定文件上传时文件域的名称，默认为file,例如在php中你可以使用$_FILES['file']来获取上传的文件信息
containerDOM/String 用来指定Plupload所创建的html结构的父容器，默认为前面指定的browse_button的父元素。该参数的值可以是一个元素的id,也可以是DOM元素本身。
flash_swf_urlStringjs/Moxie.swfflash上传组件的url地址，如果是相对路径，则相对的是调用Plupload的html文档。当使用flash上传方式会用到该参数。
silverlight_xap_urlStringjs/Moxie.xapsilverlight上传组件的url地址，如果是相对路径，则相对的是调用Plupload的html文档。当使用silverlight上传方式会用到该参数。

各种事件说明

要了解plupload的运行状况，靠的就是在这些事件了

Init
当Plupload初始化完成后触发监听函数参数：(uploader)

 

uploader为当前的plupload实例对象

PostInit
当Init事件发生后触发监听函数参数：(uploader)

 

uploader为当前的plupload实例对象

OptionChanged
当使用Plupload实例的setOption()方法改变当前配置参数后触发监听函数参数：(uploader,option_name,new_value,old_value)

 

uploader为当前的plupload实例对象，option_name为发生改变的参数名称，new_value为改变后的值，old_value为改变前的值

Refresh
当调用plupload实例的refresh()方法后会触发该事件，暂时不清楚还有什么其他动作会触发该事件，但据我测试，把文件添加到上传队列后也会触发该事件。监听函数参数：(uploader)

 

uploader为当前的plupload实例对象

StateChanged
当上传队列的状态发生改变时触发监听函数参数：(uploader)

 

uploader为当前的plupload实例对象

UploadFile
当上传队列中某一个文件开始上传后触发监听函数参数：(uploader,file)

 

uploader为当前的plupload实例对象，file为触发此事件的文件对象

BeforeUpload
当队列中的某一个文件正要开始上传前触发监听函数参数：(uploader,file)

 

uploader为当前的plupload实例对象，file为触发此事件的文件对象

QueueChanged
当上传队列发生变化后触发，即上传队列新增了文件或移除了文件。QueueChanged事件会比FilesAdded或FilesRemoved事件先触发监听函数参数：(uploader)

 

uploader为当前的plupload实例对象

UploadProgress
会在文件上传过程中不断触发，可以用此事件来显示上传进度监听函数参数：(uploader,file)

 

uploader为当前的plupload实例对象，file为触发此事件的文件对象

FilesRemoved
当文件从上传队列移除后触发监听函数参数：(uploader,files)

 

uploader为当前的plupload实例对象，files为一个数组，里面的元素为本次事件所移除的文件对象

FileFiltered
暂不清楚该事件的意义，但根据测试得出，该事件会在每一个文件被添加到上传队列前触发监听函数参数：(uploader,file)

 

uploader为当前的plupload实例对象，file为触发此事件的文件对象

FilesAdded
当文件添加到上传队列后触发监听函数参数：(uploader,files)

 

uploader为当前的plupload实例对象，files为一个数组，里面的元素为本次添加到上传队列里的文件对象

FileUploaded
当队列中的某一个文件上传完成后触发监听函数参数：(uploader,file,responseObject)

 

uploader为当前的plupload实例对象，file为触发此事件的文件对象，responseObject为服务器返回的信息对象，它有以下3个属性：

response：服务器返回的文本

responseHeaders：服务器返回的头信息

status：服务器返回的http状态码，比如200

ChunkUploaded
当使用文件小片上传功能时，每一个小片上传完成后触发监听函数参数：(uploader,file,responseObject)

 

uploader为当前的plupload实例对象，file为触发此事件的文件对象，responseObject为服务器返回的信息对象，它有以下5个属性：

offset：该文件小片在整体文件中的偏移量

response：服务器返回的文本

responseHeaders：服务器返回的头信息

status：服务器返回的http状态码，比如200

total：该文件(指的是被切割成了许多文件小片的那个文件)的总大小，单位为字节

UploadComplete
当上传队列中所有文件都上传完成后触发监听函数参数：(uploader,files)

 

uploader为当前的plupload实例对象，files为一个数组，里面的元素为本次已完成上传的所有文件对象

Error
当发生错误时触发监听函数参数：(uploader,errObject)

 

uploader为当前的plupload实例对象，errObject为错误对象，它至少包含以下3个属性(因为不同类型的错误，属性可能会不同)：

code：错误代码，具体请参考plupload上定义的表示错误代码的常量属性

file：与该错误相关的文件对象

message：错误信息

Destroy
当调用destroy方法时触发监听函数参数：(uploader)

 

uploader为当前的plupload实例对象

Plupload实例的属性

属性描述
idPlupload实例的唯一标识id
state当前的上传状态，可能的值为plupload.STARTED或plupload.STOPPED，该值由Plupload实例的stop()或statr()方法控制。默认为plupload.STOPPED
runtime当前使用的上传方式
files当前的上传队列，是一个由上传队列中的文件对象组成的数组
settings当前的配置参数对象
total表示总体进度信息的QueueProgress对象

四、Plupload实例的方法

方法描述
init()初始化Plupload实例
setOption(option, [value])设置某个特定的配置参数,option为参数名称，value为要设置的参数值。option也可以为一个由参数名和参数值键/值对组成的对象，这样就可以一次设定多个参数，此时该方法的第二个参数value会被忽略。
getOption([option])获取当前的配置参数，参数option为需要获取的配置参数名称，如果没有指定option，则会获取所有的配置参数
refresh()刷新当前的plupload实例，暂时还不明白什么时候需要使用
start()开始上传队列中的文件
stop()停止队列中的文件上传
disableBrowse(disable)禁用或启用plupload的文件浏览按钮,参数disable为true时为禁用，为false时为启用。默认为true
getFile(id)通过id来获取文件对象
addFile(file, [fileName])向上传队列中添加文件，如果成功添加了文件，会触发FilesAdded事件。参数file为要添加的文件,可以是一个原生的文件,或者一个plupload文件对象,或者一个input[type="file"]元素,还可以是一个包括前面那几种东西的数组；fileName为给该文件指定的名称
removeFile(file)从上传队列中移除文件，参数file为plupload文件对象或先前指定的文件名称
splice(start, length)从上传队列中移除一部分文件，start为开始移除文件在队列中的索引，length为要移除的文件的数量，该方法的返回值为被移除的文件。该方法会触发FilesRemoved 和QueueChanged事件
trigger(name, Multiple)触发某个事件。name为要触发的事件名称，Multiple为传给该事件监听函数的参数，是一个对象
hasEventListener(name)用来判断某个事件是否有监听函数，name为事件名称
bind(name, func, scope)给某个事件绑定监听函数，name为事件名，func为监听函数，scope为监听函数的作用域，也就是监听函数中this的指向
unbind(name, func)移除事件的监听函数，name为事件名称，func为要移除的监听函数
unbindAll()移除所有事件的所有监听函数
destroy()销毁plupload实例

文件对象的属性和方法

在很多事件监听函数中，都会提供文件对象给你

属性/方法描述
id文件id
name文件名，例如”myfile.gif”
type文件类型，例如”image/jpeg”
size文件大小，单位为字节，当启用了客户端压缩功能后，该值可能会改变
origSize文件的原始大小，单位为字节
loaded文件已上传部分的大小，单位为字节
percent文件已上传部分所占的百分比，如50就代表已上传了50%
status文件的状态，可能为以下几个值之一：plupload.QUEUED, plupload.UPLOADING, plupload.FAILED, plupload.DONE
lastModifiedDate文件最后修改的时间
getNative()获取原生的文件对象
getSource()获取mOxie.File 对象，想了解mOxie是什么东西，可以看下https://github.com/moxiecode/moxie/wiki/API
destroy()销毁文件对象

QueueProgress 对象的属性

plupload实例的total属性是一个QueueProgress对象

属性描述
size上传队列中所有文件加起来的总大小，单位为字节
loaded队列中当前已上传文件加起来的总大小,单位为字节
uploaded已完成上传的文件的数量
failed上传失败的文件数量
queued队列中剩下的(也就是除开已经完成上传的文件)需要上传的文件数量
percent整个队列的已上传百分比，如50就代表50%
bytesPerSec上传速率，单位为 byte/s，也就是 字节/秒

Plupload命名空间上的属性

Plupload的命名空间上有一些属性，用来表示一些常量。记住，不是plupload实例的属性，而是plupload的属性

属性名称描述
VERSION当前plupload的版本号
STOPPED值为1，代表上传队列还未开始上传或者上传队列中的文件已经上传完毕时plupload实例的state属性值
STARTED值为2，代表队列中的文件正在上传时plupload实例的state属性值
QUEUED值为1，代表某个文件已经被添加进队列等待上传时该文件对象的status属性值
UPLOADING值为2，代表某个文件正在上传时该文件对象的status属性值
FAILED值为4，代表某个文件上传失败后该文件对象的status属性值
DONE值为5，代表某个文件上传成功后该文件对象的status属性值
GENERIC_ERROR值为-100，发生通用错误时的错误代码
HTTP_ERROR值为-200，发生http网络错误时的错误代码，例如服务气端返回的状态码不是200
IO_ERROR值为-300，发生磁盘读写错误时的错误代码，例如本地上某个文件不可读
SECURITY_ERROR值为-400，发生因为安全问题而产生的错误时的错误代码
INIT_ERROR值为-500，初始化时发生错误的错误代码
FILE_SIZE_ERROR值为-600，当选择的文件太大时的错误代码
FILE_EXTENSION_ERROR值为-601，当选择的文件类型不符合要求时的错误代码
FILE_DUPLICATE_ERROR值为-602，当选取了重复的文件而配置中又不允许有重复文件时的错误代码
IMAGE_FORMAT_ERROR值为-700，发生图片格式错误时的错误代码
IMAGE_MEMORY_ERROR当发生内存错误时的错误代码
IMAGE_DIMENSIONS_ERROR值为-702，当文件大小超过了plupload所能处理的最大值时的错误代码

 

boonya
关注
专栏目录
使用plupload.js上传文件
huangwen123456的博客
08-11 2711
1、引入js文件 2、html文件 <input id="filecomment" class="data_sc data_sc1" type="hidden"> <span class="choseFile"> <input type="button" name="" id="browse&
阿里云oss文件上传之plupload插件使用方法
weixin_39583725的博客
12-20 3823
plupload使用概述： html页面上必须得有一个触发浏览器文件选择弹框的元素，这个元素必须拥有一个id，这个id需要配置在plupload实例化方法中（下面有具体实例）； <a-button id="selectLogoFiles"> 添加图片 </a-button> plupload具体配置： 第一步，安装依赖 yarn add plupload // ...
Plupload上传插件中文帮助文档
weixin_33991727的博客
03-24 226
Plupload上传插件中文帮助文档 配置参数 实例化一个plupload对象时，也就是 new plupload.Uploader()，需要传入一个对象作为配置参数。后面内容中出现的plupload实例均是指new plupload.Uploader()得到的实例对象 属性类型默认值描述 browse_button String / DOM   触发文件选择对话...
plupload.js
06-11
JS文件上传插件plupload.js。Plupload有以下功能和特点：拥有多种上传方式，支持以拖拽的方式来选取要上传的文件...
Plupload 开源项目安装与使用指南
最新发布
gitblog_00486的博客
08-22 936
Plupload 开源项目安装与使用指南 pluploadPlupload is JavaScript API for building file uploaders. It supports multiple file selection, file filtering, chunked upload, client side image downsizing and when necessa...
Plupload中文文档
weixin_30556959的博客
07-24 540
项目中用到改上传插件，因此抽了一晚上事件把列子和文档看了一下，翻译过来，如有错误的翻译请帮助我一起纠正谢谢。 介绍： Plupload是有TinyMCE的开发者开发的，为您的内容管理系统或是类似上传程序提供一个高度可用的上传插件。Plupload目前分为一个核心API和一个jQuery上传队列部件，这样使你可以直接使用或是自己定制。 特性： 注释：1、gears：http...
Plupload 上传控件使用指南
weixin_30457551的博客
08-26 1148
本文转载至(感谢原作者分享)：http://www.cnblogs.com/2050/p/3913184.html#plupload_doc2 我之前写过一篇文章《文件上传利器SWFUpload使用指南》，里面介绍了上传组件SWFUpload的使用方法，但现在随着html5技术的逐渐推广和普及，再去使用以flash为上传手段的SWFUpload显然就有点过时了，毕竟html5原生的就给我们提...
js插件（jquery,plupload）
04-25
在使用plupload上传文件时需要用到的插件，在我的一篇文章中实现了同一jsp中创建多个上传控件的demo，有需要的可以看看
JS插件plupload.js实现多图上传并显示进度条
10-21
标题中的“JS插件plupload.js实现多图上传并显示进度条”指的是使用JavaScript插件plupload.js来处理用户在网页上选择并上传多张图片的功能，并且在上传过程中显示实时的进度条，以便用户了解文件上传的状态。...
jQuery Plupload上传插件的使用
10-19
以下是关于jQuery Plupload上传插件使用详解的知识点： 1. Plupload的基本介绍： - Plupload是一个跨浏览器的文件上传组件，支持HTML5, Flash, Silverlight以及传统HTML4上传技术。 - 它支持多文件上传、文件拖拽...
plupload上传插件做切片上传
Nick的博客
10-16 296
plupload能够兼容Safari~ 首先下载官方的js：https://www.plupload.com/download/ 然后在盒子上绑定id以供插件生成上传表单 $('#picker').each(function (item,index) { var uploader = new plupload.Uploader({ runtimes: 'html5,flash,silverlight,html4', browse_button:'picker'
plupload-2.3.4 最新js文件
10-11
plupload拥有多种上传方式：HTML5、flash、silverlight以及传统的<input type=”file” />。Plupload会自动侦测当前的环境，选择最合适的上传方式，并且会优先使用HTML5的方式。所以你完全不用去操心当前的浏览器支持哪些上传方式，Plupload会自动为你选择最合适的方式。
javascript+HTML5 多文件上传（插件）多进度条显示
02-06
html5和js多文件上传插件。可任意多文件选择上传，每个文件都可以显示进度，同时可以显示整体进度。采用了html的file对象和blob对象的属性和方法。
利用Plupload.js解决大文件上传问题, 带进度条和背景遮罩层
10-20
本篇文章主要介绍了c#+Plupload.js解决大容量文件上传问题, 带进度条和背景遮罩层，具有一定的参考价值，感兴趣的小伙伴们可以参考一下。
plupload-api文档
08-03
plupload简单的API文档，希望能对学习的人有所帮助 一、配置参数 二、各种事件说明 三、Plupload实例的属性 四、Plupload实例的方法 五、文件对象的属性和方法 六、QueueProgress 对象的属性 七、plupload命名空间上的一些属性
Plupload一个文件上传模块，很好用的
03-01
一个开源的功能丰富而且强大的优秀文件上传模块，可以通过 JavaScript API 或 jQuery plugin 使用。 Plupload 有一些非常强大的功能，比如： •智能缩图 •显示上传进度条 •支持拖动 •多文件同时上传 •生成唯一的文件名 •最大文件限制 •……
plupload上传插件
12-03
**plupload上传插件**是一款强大的、跨平台的文件上传组件，它支持多种浏览器和多种技术栈，如Flash、HTML5、Silverlight和Gears，确保在不同环境下都能实现稳定高效的文件上传功能。该插件设计的目标是提供一个统一...
php plupload,Plupload中文文档
weixin_39562338的博客
03-10 253
项目中用到改上传插件，因此抽了一晚上事件把列子和文档看了一下，翻译过来，如有错误的翻译请帮助我一起纠正谢谢。介绍：Plupload是有TinyMCE的开发者开发的，为您的内容管理系统或是类似上传程序提供一个高度可用的上传插件。Plupload目前分为一个核心API和一个jQuery上传队列部件，这样使你可以直接使用或是自己定制。特性：3、browserplus:http://developer....
js上传控件 plupload 使用记录
weixin_33774615的博客
03-22 98
最近一个项目需要使用一个上传控件进行多图片上传，给用户更好的体验，找到了plupload，用了一下感觉还是不错的， 1.从官网上  可以获得例子 ，我集成到了jsp，如下： &lt;%@ page language="java" import="java.util.*" pageEncoding="utf-8"%&gt;    &lt;!DOCTYPE HTML PU...
Plupload前端文件上传插件使用教程
"这篇文档是关于前端文件上传插件Plupload的使用教程，主要涵盖了前端部分的功能和配置，包括多种上传方式支持、上传进度、图片处理、多文件上传、拖拽上传、文件过滤以及分块上传等特性。文档强调了在实际项目中的...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值