今天开始的几篇帖子都是关于 Ext JS 布局的。伴随这一系列开始,我打算以制作一个 MSN 式的界面展开内容,也就是一个通讯器,通讯器它有展现联系人、联系人状态的地方,还有展现回话的区域。我们的目标不是实现一个消息传递系统,只是介绍其用户界面的构建过程,并有一些教学为目的的代码完成全文。
首先介绍通讯器的“联系人”区域部分,以 Ext.Window 作为容器。位于 Window 之中我会放置若干控件,控件应符合以下需求:
- 显示用户名称、头像和当前的状态。
- 可以让用户改变她当前的状态,可选:“在线、忙、离开或离线”。
- 可以让用户分享一段简洁的信息(译注:类似于 QQ 的签名功能),并告知她在听着什么的音乐/歌曲。
- 可以让用户进入她的个人信息、联系卡片或空间。
- 显示用户的联系列表,以“是否最爱、是否在线、是否离线”划分。
接下来的帖子我会继续增强这界面。到该贴介绍完毕之时,我们所弄的 Window 应该会是像这样子:
样子好像有点熟悉吧?:-)
好的,马上开工!
通讯器窗体
前面已经说过了,我们采用 Window 作为容器。现在所做的只是设置窗体的标题和尺寸。
var wnd = new Ext.Window({ width: 300, height: 450, layout:'fit', title: 'Instant Messenger' });
截图如下:
显示用户名称、头像和当前的状态
显示用户名称、头像和状态的话就使用窗体的工具条 toolbar。第一步我是第一个工具条(如代码中的 tbar ),并创建一个按钮组把工具条分为两列(columns),一列用于头像,一列用于显示用户的名称:
var wnd = new Ext.Window({ width: 300, height: 450, layout:'fit', title: 'Instant Messenger', tbar: [{ xtype: 'buttongroup', columns: 2 }] });
头像和用户名都做成为工具条中的按钮。这样做的目的是我想用户点击头像和用户名的时候,就会执行一些函数。Window现在就变为:
<pre> var wnd = new Ext.Window({ width: 300, height: 450, layout:'fit', title: 'Instant Messenger', tbar: [{ xtype: 'buttongroup', columns: 2, items: [ { xtype: 'button', scale: 'large', iconCls: 'icon-user', rowspan: 2 }, { xtype: 'splitbutton', text: 'Jorge (available)' } ] }] });</pre>
看起来还不错吧!?
用户改变其状态
要改变某种状态,我们在用户名的按钮中插入一个菜单,如下代码:
var wnd = new Ext.Window({ width: 300, height: 450, layout:'fit', title: '即時信息', tbar: [{ xtype: 'buttongroup', columns: 2, items: [{ xtype: 'button', scale: 'large', iconCls: 'icon-user', rowspan: 2 }, { xtype: 'splitbutton', text: 'Jorge (available)', menu: [{ text: 'Available', iconCls: 'ico-sts-available' }, { text: 'Busy', iconCls: 'ico-sts-busy' }, { text: 'Away', iconCls: 'ico-sts-away' }, { text: 'Appear Offline', iconCls: 'ico-sts-offline'}] }] }] }); 结果如下:
让用户分享一段简洁的信息,或她在听着什么的音乐/歌。
要实现该功能,我使用了split 按钮,就放在用户名按钮的下面:
var wnd = new Ext.Window({ width: 300, height: 450, layout:'fit', title: 'Instant Messenger', tbar: [{ xtype: 'buttongroup', columns: 2, items: [{ xtype: 'button', scale: 'large', iconCls: 'icon-user', rowspan: 2 }, { xtype: 'splitbutton', text: 'Jorge (available)', menu: [{ text: 'Available', iconCls: 'ico-sts-available' }, { text: 'Busy', iconCls: 'ico-sts-busy' }, { text: 'Away', iconCls: 'ico-sts-away' }, { text: 'Appear Offline', iconCls: 'ico-sts-offline'}] },{ xtype: 'splitbutton', text: 'Share a quick message', menu: [{ text: 'Show what I am listening to'}] }] }] });
让用户进入她的个人信息、联系卡片或空间
我将如上的功能加到头像的那个按钮中去:
var wnd = new Ext.Window({ width: 300, height: 450, layout:'fit', title: 'Instant Messenger', tbar: [{ xtype: 'buttongroup', columns: 2, items: [{ xtype: 'button', scale: 'large', iconCls: 'icon-user', rowspan: 2, menu: [{ text: 'Show profile' }, { text: 'View contact card' }, { text: 'Go to your space'}] },{ xtype: 'splitbutton', text: 'Jorge (available)', menu: [{ text: 'Available', iconCls: 'ico-sts-available' }, { text: 'Busy', iconCls: 'ico-sts-busy' }, { text: 'Away', iconCls: 'ico-sts-away' }, { text: 'Appear Offline', iconCls: 'ico-sts-offline'}] },{ xtype: 'splitbutton', text: 'Share a quick message', menu: [{ text: 'Show what I am listening to'}] }] }] });
菜单效果如下:
可以让用户改变她当前的状态,可选:“在线、忙、离开或离线”
联系人的列表就是一个TreeView。我会创建一个不可见的根节点(root node),拥有三个分支节点,叫做“在线”、“忙”、“离开”或“离线”。那么用户的联系列表将会加入到这些分支节点中。
首先在窗体中置入一个tree:
items: [{ xtype: 'treepanel', id: 'contacts-tree', border: false, useArrows: true, autoScroll: true, animate: true, containerScroll: true, bodyCssClass: 'tree-body', dataUrl: 'messenger.aspx', requestMethod: 'get', rootVisible: false, root: { nodeType: 'async', text: 'My Reporting Project', draggable: false, id: 'root-node' }}]
上面就是定义了一个Window窗体,里面还有根节点。这里就是加入“在线”、“忙”、“离开”或“离线”分支节点了,当然还有一些演示用途的联系人。afterrender 事件将会用来获取根节点的引用,在它身上加入子的节点。
var tree = Ext.getCmp('contacts-tree'); tree.on('afterrender', function(loader, node) { var root = tree.getRootNode(); var node = root.appendChild({ id: 'favorites', text: 'Favorites', expanded: true, iconCls: 'ico-fav' }); node.appendChild({ text: 'Susie', leaf: true, iconCls: 'ico-sts-available' }); node.appendChild({ text: 'Lara', leaf: true, iconCls: 'ico-sts-away' }); node = root.appendChild({ text: 'Available', expanded: true, iconCls: 'ico-grp-available' }); node.appendChild({ text: 'Jonh', leaf: true, iconCls: 'ico-sts-busy' }); node.appendChild({ text: 'Lara', leaf: true, iconCls: 'ico-sts-away' }); node.appendChild({ text: 'Susie', leaf: true, iconCls: 'ico-sts-available' }); node = root.appendChild({ text: 'Offline', expanded: true, iconCls: 'ico-grp-offline' }); })
出来的窗体的确如我们所料:
差不多这样子了,接下来我们继续对联系人窗体加入更多的功能。
上述内容中,MSN式的通讯器的布局可显示用户的状态,显示用户的联系人列表,并提供修改状态的菜单、分享签名消息和进入用户个人信息或联系人的卡片。
需要重申的是,本文的目标不涵盖后台方面的实现,也就是不讨论整个IM系统的设计,只是设计关于Ext UI部分的内容。
本文的目标是在我构建的窗体上加入几项视觉任务:
- 当右击联系人TreeView的“熟人”节点时,出现“编辑熟人列表"和“改变布局”。
- 当任何联系人节点被右击时,出现“发送即时讯息”、“发送邮件讯息”和“加入熟人列表几项”。
完成的时候应该会是这样的:
用Ext.Action类代替菜单的处理函数
“编辑熟人列表 Edit favorites” 和“改变布局 Change favorites layout ”这两项功能,对应的功能就是在它们的 Ext.Action实例中。我定义其 tex 以及 handler 两个配置项在对应设置菜单项的 text 文本和 handler 函数。
var editFavAction = new Ext.Action({ text: 'Edit favorites', handler: function() { Ext.Msg.alert('Action executed', 'Edit favorites...'); } }); var changeFavAction = new Ext.Action({ text: 'Change favorites layout', handler: function() { Ext.Msg.alert('Action executed', 'Change favorites layout...'); } }); var favMenu = new Ext.menu.Menu({ items: [editFavAction, changeFavAction] });
favMenu 菜单就会像这样:
同样的套路,Action 的实例也的实例也可执行“发送即时讯息 Send instant message ”、“发送邮件讯息 Send instant message ”和“加入熟人列表 Send instant message ”的功能:
var sendImAction = new Ext.Action({ text: 'Send instant message', handler: function() { Ext.Msg.alert('Action executed', 'Send instant message...'); } }); var sendMailAction = new Ext.Action({ text: 'Send email message', handler: function() { Ext.Msg.alert('Action executed', 'Send email message...'); } }); var addToFavesAction = new Ext.Action({ text: 'Add to favorites', handler: function() { Ext.Msg.alert('Action executed', 'Add to favorites...'); } }); var contactMenu = new Ext.menu.Menu({ items: [sendImAction, sendMailAction, '-', addToFavesAction] });
contactMenu 菜单就会这样:
Action 之目的在于允许不同的组件之间均使用同一个 Action,共享这个 Action 的各项功能。尽管在这个例子中不是太明显,但在以后的例子就不一定用不上。假设一个例子,全局菜单有某一菜单项,右键菜单中又会有同样的菜单项,那么就可以把这菜单项的功能独立出来,甚至在其他的地方不断复用。
var globalMenu = new Ext.menu.Menu({ items: [editFavAction, changeFavAction,'-', sendImAction, sendMailAction,'-', addToFavesAction] });
创建 Ext.tree.TreePanel 实例的右键菜单
树面板为我们提供了 contextmenu 事件,触发该事件换言之是出现“编辑熟人列表 Edit favorites "和“改变布局 Change favorites layout ”的菜单。要决定哪一种菜单会被显示,我们只需要检查一下所选节点的 id:
listeners: { contextmenu: function(node, e) { node.select(); var contextMenu; if (node.id == 'favorites') { contextMenu = favMenu; } else if (node.id != 'available' && node.id != 'offline') { contextMenu = contactMenu; } if (contextMenu) { contextMenu.contextNode = node; contextMenu.showAt(e.getXY()); } } }
请注意Available 或 Offline 分支被选取的时候,哪个菜单的不活动的。
最后,下面给出网友制作的聊天 Session “对话框”,作为 UI 的补充。
完整的代码下载:
http://miamicoder.com/file.axd?file=ExtJs_Messenger_Layout_1.zip
http://miamicoder.com/file.axd?file=ExtJs_Messenger_Layout_2.zip