前言
图片管理要在两个地方使用:一是标签页内的图片管理,一是文章内容编辑时嵌套到插入图片的窗口内。因而,将图片管理做成一个扩展比较方便。当然,做成MVC模式也行,不争论,不讨论。
要记住,扩展要写在Scripts\ExtJS\Ux目录下,因为在路径的设置中,扩展目录是指向这里的。在该目录下创建一个名为PicManager.js的脚本文件。
片管理的主要界面分两部分,左边以树的形式列出文件目录,要实现目录的添加、删除和编辑功能,右边则以预览形式显示目录中的文件,主要功能是上传文件和删除文件。
上传文件将使用Swfupload,它可一次上传多个文件,到http://code.google.com/p/swfupload/可下载到最新版本的文件,当前示例使用的是2.5.0 beta版本。先下载SWFUpload_v250_beta_3_samples.zip这个文件,解压后,把demos目录下的swfupload目录复制到解决方案的Scripts目录下。然后下载swfupload.swf.v2.5.0.beta3.2.zip文件,把该文件里的文件覆盖swfupload目录下的文件。
正题
现在先来完成左边的目录树。使用树,必然用到TreeStore,因而要从这里入手。而TreeStore可定义模型,也可不定义模型,这个视情况而定。目前的情况是,目录的添加、编辑和删除操作,都需要给出父目录和目录名称,目录名称可使用字段text,父目录则是一个附加字段。目录的操作比较简单,因而直接在模型内完成就行了,因而定义模型是比较好的方法。模型的定义可以独立成一个文件,也可以在initComponet方法内定义。如果在独立的文件定义,就要在扩展中添加requires配置项引用模型。这里将在initComponet方法内定义,代码如下:
Ext.define("Folder", { extend: "Ext.data.Model", fields: ["text", "id", "parentId"], validations: [{ type: 'presence', field: 'text' }], proxy: { type: 'ajax', api: { read: 'Folder/List', create: 'Folder/Add', destroy: 'Folder/Delete', update: 'Folder/Edit' }, reader: { messageProperty: "Msg", type: 'json', root: "data" }, writer: { type: "json", encode: true, root: "data", allowSingle: false }, listeners: { exception: ExtMVCOne.ProxyException } } });
定义中,parentId用来记录父目录。添加一个验证项,目录名称不能为空。在代理定义中,reader和writer的定义可标准化数据的输入输出,这个与用户中的定义是一样的。代理的API则定义了操作的提交路径。
接下来定义TreeStore,代码如下:
me.treestore = Ext.create("Ext.data.TreeStore", { root: { id: "/", text: "根目录", expanded: true }, model: "Folder" });
TreeStore的定义,除了模型,很重要的一个定义就是根节点了。这里根节点的id使用“/”,是为了方便后台将虚拟路径转换为实际路径。
接着定义树面板,代码如下:
me.tree = Ext.widget("treepanel", { title: "文件目录", region: "west", collapsible: true, rootVisible: true, 250, minWidth: 100, maxWidth: 500, split: true, store: me.treestore });
因为使用边框布局,因而要混入边框布局的配置项。这里还设置了显示根目录,这是因为系统将允许在根目录上传文件。
现在来完成右边的文件预览。还是先从模型开始,代码如下:
Ext.define('File', { extend: 'Ext.data.Model', fields: [ 'filename', 'path', "modify", { name: "size", type: "int" } ] });
这里的字段,除了文件名、路径是必须的,其它的可根据自己的显示内容定义。在这里将显示最后编辑时间、文件大小。
接着是定义Store,代码如下:
me.filestore = Ext.create("Ext.data.Store", { batchActions: false, remoteFilter: false, remoteSort: false, pageSize: 50, model: "File", proxy: { type: "ajax", api: { read: 'File/List', destroy: 'File/Delete' }, reader: { type: 'json', root: "data" }, writer: { type: "json", encode: true, root: "data", allowSingle: false }, listeners: { exception: SimpleCMS.ProxyException } } });
这里的API没有create和update配置项是因为,文件是上传的,不能通过该方式提交,而文件一般也不进行更新,而是先删除后再上传。
接着是用数据视图来显示文件,代码如下:
me.dataview = Ext.widget("dataview", { store: me.filestore, autoScroll: true, multiSelect: true, selectedItemCls: "selected", itemSelector: 'div.imageList', overItemCls: "overitem", trackOver: true, tpl: [ '<tpl for=".">', '<div class="imageList">', '<img width="160" height="160" src="../Thumbnail{path}{filename}?width=160&height=160" data-qtip="文件名:{filename}<br/>修改日期:{modify}<br>大小:{size:this.filesize}" /><br/>', '<p class="ellipsis">{filename}</p>', '</div>', '</tpl>', '<div class="x-clear"></div>', { filesize: function (size) { if (size < 1024) { return v + " 字节"; } else if (size < 1048576) { return (Math.round(((size * 10) / 1024)) / 10) + " KB"; } else { return (Math.round(((size * 10) / 1048576)) / 10) + " MB"; } } } ] });
定义数据视图的关键就是模板的定义,这个在书中有详细说明和示例,这里就不详细说了。在这里在模板添加了一个filesize方法,用来转换文件大小的显示格式。
因为视图不是面板,没有工具栏组件,因而要在其外面套一个面板用来放置工具栏,所以在视图的定义中没有边框布局的配置项。
下面来完成整个界面框架,代码如下:
me.items = [ me.tree, { title: "图片文件", region: "center", layout: 'fit', items: [me.dataview] } ];
现在可以调试一下界面,看看怎么样了。先切换到主面板(mainpanel.js)的视图定义,为图片管理加回布局,布局类型为Fit。然后切换到主面板的控制器,在图片管理的activate方法内,删除alert语句,添加以下代码:
var view = Ext.create('Ext.ux.PicManager', {}); var view = Ext.widget("picmanager"); panel.add(view);
这里一定要注意,create方法的第一参数必须为字符串,这样,Ext才会去自动加载类文件。也不能使用widget方法去创建,因为类还没注册,Ext不知道别名为picmanager指向的是那个类,也就不会去自动加载了。如果不使用这样的方式,可在控制器中加入requires配置项,指定要加载该类,不过这与初衷相违了。
为了调试方便,可在主面板视图定义中加入配置项activeTab,用来指定初始激活显示那个标签页,这样就不用每次调试都要单击一次标签了。图片管理是第二个标签页,因而设置当前索引为1。
就这样页面就暂时加载出来了。