利用Flash上传大文件:swfupload修改以及详细说明
Flash Player 8可以支持100MB以下的大文件上传。目前,已经有许多网站利用Flash Player的这个特性来上传大文件了。例如著名的youtube,Box.net国内的G宝盘等等。在互联网上,很早我就找到了这个不错的开源swf上传组件:SWFUpload,但是由于它不太符合项目需求,并且没有帮助材料,我对它进行了一些修改。
注意:SWFUpload组件的版权归原作者所有
修改主要体现在以下几个方面:
- 由“一选择就上传”改为“先选择,后上传”;
- 加入了选择成功的回调函数设定
- 支持单文件上传和多文件上传模式
- 可以删除待上传队列中的文件
- 支持按照设定的顺序上传特定类型的文件
以下是针对此组件所写的一个比较详细的中文说明:
1使用说明:
2
3将jscripts目录上传至服务器,不要修改其中的文件路径
4mmSWFUpload.js是调用swf的核心文件,不要修改其路径和内容
5upload.swf是上传主功能所在文件,不要修改其路径和内容
6progressbar.png是上传进度条图像文件,可以替换和修改
7
8example.js是定义本例所使用的JavaScript函数的文件,可以修改
9example.css定义本例的外观,可以修改
10index.htm是本文件,可以修改
11
12进度条、选择文件的列表等所有效果全部由JavaScript实现,具体的实现未知详见sample.js中相关函数
13
14=============================================================
15swf提供的供JavaScript调用的函数
16
17mmSWFUpload.callSWF()
18此函数打开一个选择文件对话框
19当选择成功时,swf会回调select_done_callback参数中定义的JavaScript函数,
20当选择不成功(取消)时,swf会回调upload_cancel_callback参数中定义的JavaScript函数
21使用示例:<a href="javascript:mmSWFUpload.callSWF();">选择文件</a>
22
23mmSWFUpload.doDelete()
24此函数删除待上传文件队列中的最后一个文件
25当删除成功时,swf会回调delete_done_callback中定义的JavaScript函数
26使用示例:<a href="javascript:mmSWFUpload.doDelete();">删除</a>
27
28mmSWFUpload.doUpload()
29此函数告知swf开始上传文件队列
30当上传开始时,swf会回调upload_start_callback中定义的函数
31当上传正在进行中时,swf会回调upload_progress_callback中定义的函数
32当上传出错时,swf会回调upload_error_callback中定义的函数
33当上传完成时,swf会回调upload_complete_callback中定义的函数
34当队列中的所有文件上传完成时,swf会回调upload_queue_complete_callback中定义的函数
35使用示例:<a href="javascript:mmSWFUpload.doUpload();">上传</a>
36
37=============================================================
38参数介绍:
39
40debug
41是否使用调试模式,在调试模式下会显示mmSWFUpload的设置信息
42
43upload_backend
44用于上传的后台程序地址。这个地址是相对于mmSWFUpload.js的
45
46target
47swf显示于那个div中?这里指定div的id
48
49link_mode
50如果不希望自动显示上传链接,将值设为standalone
51
52link_text
53上传链接的文字。如果使用了link_mode,则参数无效。
54如果希望用一个图片代替上传链接,则注释此行,设定css_class参数值
55
56css_class
57用于修饰上传链接。这是一个CSS类的名称
58
59allowed_filesize
60允许的最大文件大小。单位KB
61
62select_mode
63值为空: 只能选择一个文件上传,每次选择的新文件会替换旧文件
64值为multifile: 每次选择的新文件会加在待上传文件队列的末尾
65值为multifileLimit:这种情况下,必须定义select_multifile_limit,
66根据select_multifile_limit定义的扩展名顺序选择上传文件,
67如果选择的文件顺序与select_multifile_limit定义的顺序不匹配,
68则会禁止选择并调用upload_error_callback,错误代码为-60。
69当按照定义的顺序选择文件完毕后,会调用select_multifile_done_callback定义的JavaScript函数。
70
71select_multifile_limit
72此参数仅当select_mode值为multifileLimit时有效
73定义要按顺序上传的文件扩展名,扩展名间用英文半角逗号分隔
74例如要上传三个文件,第一个为jpg图片,第二个为doc文档,第三个为zip压缩包,
75则定义为“.jpg,.doc,.zip”
76
77allowed_filetypes
78允许的文件扩展名
79
80==============================================================
81函数介绍:
82
83此处的参数定义的是当一个事件发生时swf调用的JavaScript函数名称
84
85upload_start_callback
86上传开始的时候调用,参数介绍见sample.js中的uploadStart定义
87
88upload_progress_callback
89上传进行中调用,参数介绍见sample.js中的uploadProgress定义
90
91upload_complete_callback
92上传完成调用,参数介绍见sample.js中的uploadComplete定义
93
94upload_error_callback
95上传失败调用,参数介绍见sample.js中的uploadError定义
96
97upload_cancel_callback
98上传取消调用,参数介绍见sample.js中的uploadCancel定义
99
100upload_queue_complete_callback
101所有上传队列完成后调用,参数介绍见sample.js中的uploadQueueComplete定义
102
103select_done_callback
104选择一个文件成功后回调,参数介绍见sample.js中的selectedDone定义
105
106select_multifile_done_callback
107此函数仅当select_mode值为multifileLimit时有效
108当按照select_multifile_limit定义的顺序选择完成后调用
109参数介绍见sample.js中的selectMultifileDone定义
110
111delete_done_callback
112当在上传列表中删除一个已经选择的等待上传的文件时调用
113删除待上传文件使用mmSWFUpload.doDelete()
114参数介绍见sample.js中的deleteDone定义
修改后的组件下载:
=======================================================================
PS.
本文的修改是基于0.8.5版本进行的,写完这篇文章,又去SWFUpload主页看了看,发现作者已经将其更新到1.0.2版本,并且改用FlashDevelop开发(原来使用Flash IDE开发)。新版本提供了一个选项auto_upload来控制是自动上传还是先选择后上传,网站上还提供了详细的帮助文档。
- 文章ID:331
- 原文作者:zrong
- 原文链接:https://blog.zengrong.net/post/swfupload/
- 版权声明:本作品采用 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 进行许可,非商业转载请注明出处(原文作者,原文链接),商业转载请联系作者获得授权。