rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"> rel="Edit-Time-Data" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_editdata.mso">
Ext没提供上传组件?很多人都会有这疑问。
其实Ext.form.TextField就是Ext的上传组件的,只要将其配置参数inputType设置为“file”就行了。上传文件除了文件输入框,还有一个重要的设置,就是需要将form的enctype属性设置为“multipart/form-data”。这个也很简单,在定义FormPanel的时候加入BasicForm的配置参数fileUpload,并设置为true就行了。
在Ext中使用标准上传方式最大的缺点就是文件输入框的宽度很难控制,与界面不是太协调,而且在不同浏览器中的显示是不同的。在Ext官方论坛中有很多替代办法,笔者比较喜欢的是SWFUpload。
SWFUpload使用Flash作为上传组件,文件选择可以设置为单选,也可以设置多选,而且可以控制选择文件的类型。执行文件选择不依赖于标准文件输入框,可以使用按钮、链接等多种方式执行,从而可以根据需要设置界面。SWFUpload的提交不依赖Form,其模式类似于Ajax提交,可以很容易的实现对上传的控制和显示上传进度。
SWFUpload的官方地址是:http://www.swfupload.org/。
在SWFUpload中有两个主要对象:file和Stats。
file对象主要是保存文件的一些基本信息,其结构如下:
|
Stats对象主要提供上传队列中的信息,其结构如下:
|
表1列出了SWFUpload的主要配置参数。
表1 SWFUpload的主要配置参数 | ||
参数 | 类型 | 描述 |
upload_url | 字符串 | 文件上传地址 |
flash_url | 字符串 | SWFUpload使用的flash文件的绝对地址或相对地址 |
file_size_limit | 字符串 | 限制上传文件的大小 格式为:值+单位 允许的单位有B、KB、MB和GB。如果不设置单位,则默认单位为KB 如果设置为0则无限制 |
file_upload_limit
| 数字 | 允许上传的文件数量,该值表示的是在上传页面没有被销毁前允许上传的文件数量。默认值为0,表示没有限制 |
file_queue_limit | 数字 | 在一次上传过程中允许上传的文件数量,默认值为0,表示无限制 |
file_types | 字符串 | 限制上传文件的类型。使用分号分隔各类型 例如:“*.jpg;*.gif”表示只允许上传扩展名为JPG和GIF的文件 |
file_post_name | 字符串 | 服务器端接收文件的变量名,本属性只在Flash 9版本有效 |
requeue_on_error | 布尔值 | 设置为true则当文件上传错误时重新返回队列等待上传,设置为false则不再上传 |
post_params | 对象 | JSON格式的与文件一起上传的参数,Flash 8版本不支持 |
file_types_description | 字符串 | 在文件选择对话框显示的文本描述 |
flash_color | 颜色值 | 设置包含flash的HTML标签的背景颜色,默认值是“#FFFFFF” |
debug | 布尔值 | 设置为true则显示调试 |
file_queued_handler | 函数 | 当选择文件对话框关闭时执行该函数,函数会传入一个file对象 |
upload_start_handler | 函数 | 文件开始上传时执行该函数,函数会传入一个file对象 |
upload_progress_handler | 函数 | 通过该函数显示上传进度,函数传入一个file对象与文件已上传的字节数 |
upload_success_handler | 函数 | 单个文件上传成功时执行该函数,函数传入一个file对象与服务器端返回的信息 |
upload_error_handler | 函数 | 单个文件上传失败或中断时执行该函数,函数传入一个file对象、错误代码与错误信息 |
file_queue_error_handler | 函数 | 文件未能加入队列时执行该函数,函数传入一个file对象、错误代码与错误信息 |
表2列出了SWFUpload的主要方法。
表2SWFUpload的主要方法 | |
方法 | 描述 |
selectFile | 功能:打开选择文件对话框,但允许选择一个文件 语法:selectFile() 参数: 无 返回值:无 例子:swfu.selectFile() |
selectFiles | 功能:打开选择文件对话框,允许选择多个文件 语法:selectFiles() 参数: 无 返回值:无 例子:swfu.selectFiles() |
startUpload | 功能:开始上传文件 语法:startUpload ([file_id]) 参数: file_id:可选值,要上传的文件编号,如果不设置则上传队列里的第一个文件 返回值:无 例子:swfu.startUpload () |
cancelUpload | 功能:取消上传某个文件 语法:cancelUpload ([file_id]) 参数: file_id:可选值,要取消上传的文件编号,如果不设置则上传队列里的第一个文件取消上传 返回值:无 例子:swfu.cancelUpload () |
stopUpload | 功能:中止上传 语法:stopUpload () 参数: 无 返回值:无 例子:swfu.stopUpload () |
getStats | 功能:返回当前上传状态 语法:getStats () 参数: 无 返回值:stats对象 例子:vat stats=swfu.getStats () |
setPostParams | 功能:设置提交的附加参数 语法:setPostParams(param_object) 参数: param_object:一个JSON对象 返回值:无 例子:swfu. setPostParams({id:1,title:’标题’}) 该例子附加了两个提交参数,一个为id,值为1,一个为title,值为标题 |
要使用SWFUpload,需要在页面加载swfupload.js文件并设置好参数,尤其要注意Flash文件的路径。具体使用方法请看下面例子:
|
例子中使用了两种方式实现文件上传,一种是标准方式,使用Form提交,一种使用SWFUpload。
标准方式的定义比较简单,在FormPanel定义中加入fileUpload参数并设置为true,然后将一个TextField的inputType设置为file就行了。保存的提交方式与一般的Form提交没什么区别。
SWFUpload的定义稍微复杂一点。首先在onReady函数外定义了一个swfu的全局变量,主要目的是使swfu成为一个全局的SWFUpload实例,以便在内部函数中能使用该实例。
本例子使用的Flash 9版本,而且swf文件与页面文件在同一目录,所以设置flash_url为swfupload_f9.swf。允许上传的文件大小限制为10兆,只能上传JPG和GIF文件,服务器端接收文件的参数名称为Filedata。
在file_queued_handler函数中先判别上传文件的扩展名是否符合要求,如果符合则执行startUpload方法开始上传文件。
upload_start_handler函数在文件开始时显示一个Ext进度条。
upload_progress_handler函数则根据已上传字节数计算上传进度并更新进度条。
upload_success_handler函数根据服务器端返回信息更新页面显示,并判断上传队列中是否还有文件未上传,如果有则继续上传。
upload_error_handler函数与file_queue_error_handler函数则在发生错误时显示错误信息。
在FormPanel中有两个按钮,一个用来演示上传单文件,一个用来演示上传多文件。单击后先根据标题输入框的值,设置一个附加提交参数title,然后执行selectFile方法或selectFiles方法打开文件选择对话框。对话框关闭后执行file_queued_handler函数开始上传文件。
文件上传后会在id为“'imagePane'”的Panel显示上传图片的缩略图。执行操作中也会显示返回的结果。
下面看看服务器端代码如下:
|
一个很简单的只接收单文件的服务器端代码。代码中使用了客户端设置的参数Filedata接受文件数据:
HttpPostedFile jpeg_image_upload = context.Request.Files["Filedata"]; |
代码中对文件扩展名进行了判断,如果是GIF或JPG则保存文件,否则返回错误。服务器端返回格式使用了Ext的返回格式。
图1是例子的运行结果。
先测试标准方式上传,在标题输入测试,然后单击“选择”按钮选择一幅图片,单击保存按钮。
图2是文件上传后的显示。
根据返回值,参数title和文件都已成功上传。
继续单击“上传文件”按钮选择一幅图片。当选择文件窗口关闭,会出现一个进度条,可能会是一闪而过,看看返回值:
---------------------------- 执行回调函数:success 返回值:{success:true,data:'文件“测试”上传成功,文件名:20080730174659265.jpg',file:'20080730174659265.jpg'} |
参数titile与文件也同样正确上传。
可以继续单击“上传多个文件”测试上传多个文件的情况,这里就不再赘述了。
SWFUpload和标准模式不同,上传多个文件时是一个一个的文件上传的,而不是标准模式使用不同的参数同时上传。
SWFUpload最大的缺点是受浏览器Flash插件版本的限制,低于版本8的Flash插件不起作用。如果使用版本9的swf文件,则需要Flash插件版本为9以上才能用。
标签:文件,handler,节选,upload,Ext,详解,file,上传 From: https://blog.51cto.com/dqhuang/6951135