【原创】[Ext.ux.UploadDialog] 控件使用说明及在Ext 3.x下问题解决

[Ext.ux.UploadDialog]是基于ExtJS2.0开发的文件上传控件。


一. 控件说明:


该控件由以下几个对象组成:

Ext.ux.Utils.EventQueue: 通用事件处理器,对象内置一个事件队列,调用其process函数即可对队列中待处理事件进行响应处理。控件内部将上传文件过程定义成事件数组,从而在上传过程中特定的阶段触发某事件进入下一步的处理。该对象即完成针对上传过程的特定阶段中,响应事件及执行该事件所关联函数。

Ext.ux.Utils.FSA: 针对上传过程特定的事件处理器,由Ext.ux.Utils.EventQueue派生。

Ext.ux.UploadDialog.BrowseButton: 打开文件按钮控件基类。

Ext.ux.UploadDialog.TBBrowseButton:  打开文件按钮控件扩展类。本控件中的的“添加”按钮就是该对象实例。

Ext.ux.UploadDialog.Dialog: 上传控件对话框对象,及本控件的主对象。该对象由Ext.Window派生。

使用该控件时,我们只需要调用Ext.ux.UploadDialog.Dialog对象,如下:

1 dialog =new Ext.ux.UploadDialog.Dialog({
2 url: 'upload-dialog-request.php',
3 reset_on_hide: false,
4 allow_close_on_upload: true,
5 upload_autostart: true
6 });
7 ...
8 dialog.show('show-button');



在Server端处理上传文件相应代码中(不管你使用何种Web语言),在处理用户提交上传表单后,必须对外输出以下JSON字符串:

{
success:
true, // 可以为true或false. 上传成功则返回true.
error: '上传文件数据成功!'// 该信息将在GRID中每行的备注列中被显示
}

在.net项目中可以用context.Response.Write("{success:true,message:'上传文件数据成功!'}");进行输出。

更详细的使用方法请参考该控件出处: http://www.max-bazhenov.com/dev/upload-dialog-2.0/index.php



二. 调用问题及处理方法:


由于该控件是基于Ext Js 2.x版本产生的,当Ext Js升级为3.x及以上版本时会出现'x_buttons.upload.getEl()' 为空或不是对象等问题。

这是由于Ext 3.x版本中的Ext.Button 模板被改变,如下:

Ext.Button.buttonTemplate =new Ext.Template(
'<table id="{4}" cellspacing="0" class="x-btn {3}"><tbody class="{1}">',
'<tr><td class="x-btn-tl"><i>&#160;</i></td><td class="x-btn-tc"></td><td class="x-btn-tr"><i>&#160;</i></td></tr>',
'<tr><td class="x-btn-ml"><i>&#160;</i></td><td class="x-btn-mc"><em class="{2}" unselectable="on"><button type="{0}"></button></em></td><td class="x-btn-mr"><i>&#160;</i></td></tr>',
'<tr><td class="x-btn-bl"><i>&#160;</i></td><td class="x-btn-bc"></td><td class="x-btn-br"><i>&#160;</i></td></tr>',
'</tbody></table>');

这就造成了该控件源码中this.el.child(".x-btn-center");无法取得该对象,所以要修改为this.el.child(".x-btn-mc");

在对源代码进行一系列修改后,本控件可以在Ext 3.x下成功使用。

对于解决本问题详细说明请参考: http://swbssd.iteye.com/blog/600872 文章



三. 关于该控件的不足及扩展:

本控件特点是能够上传多文件,并显示上传进度。这种上传方式的确让用户在上传过程中有比较舒适的交互体验。

可是,本控件实质上并没有反应出上传的多文件中某一个具体文件的进度,也就是说,当用户上传的文件列表中存在有大文件时,该控件进度条会一直停留在这个大文件的上传的开始点,并不会反应该文件的实时上传进度。

如果想解决这个问题,则必须从服务器端程序入手,服务器端程序必须在上传的过程中,支持对外输出本次上传的进度信息,客户端在后台异步请求该进度信息的路径,请求后再显示在该控件上。

所以,如果想完全的显示每个子文件的进度信息,除了要修改或扩展[Ext.ux.UploadDialog]代码外,还需要服务器端上传代码中对外输出指定文件的上传进度信息,从而在控件中显示。

四.相关下载:

1. Ext.ux.UploadDialog 原始版(基于 Ext 2.x 版本) [下载]

2. Ext.ux.UplaodDialog 改进版(基于 Ext 3.x 版本,修正错误,增加中文信息,带调用示例)  [下载]

3. Ext.ux.UploadDialog 原始参考说明 http://www.max-bazhenov.com/dev/upload-dialog-2.0/index.php

posted @ 2011-05-12 15:38  darkprince  阅读(2888)  评论(1编辑  收藏  举报
作者自述: 本人从事十六年WINDOWS应用/游戏/设备/WEB开发,目前从事Linux,Docker及CAAS云平台架构设计及开发。 基于全球开源共享理念,本人会分享更多原创及译文,让更多的IT人从中受益,与大家一起进步! 基因Cloud 原创,转发请注明出处 1738387@qq.com (工作繁忙,有事发邮件,QQ不加,非要事勿扰,多谢!)