trswcm6.5及以上二次开发-003顶部菜单

1、修订序号变更日期变更动作变更内容详情描述版本1.2010-04-25DEV2新建新建本文档1.02.2011-01-12修改X。X。1 顶部菜单定制1.1 概述本节介绍了WCMV65 顶部菜单的相关知识，如果你需要对顶部菜单进行修改，或者添加一些新的菜单，你将这节中找到。顶部菜单包含了 WCM 几乎所有操作的入口，其中的菜单项，分成两种类型，一种菜单项的内容是固定不变的，比如菜单项“我的信息”等，如：图 1；另一种菜单项的内容或样式随着列表主区域选择对象的不同而动态改变，比如站点列表下，当列表中选择一个对象和多个对象时，菜单项将出现针对一个对象的操作和多个对象的操作，如图 2 和图 3。图 1

2、 固定的菜单项图 2 选择一个站点时的“操作任务”菜单项图 3 选择多个站点时的“操作任务”菜单项1.1.1 菜单定制涉及到的文件顶部菜单涉及到的文件都在 wcm/app/js/data/目录下，其中 sys.js 包含了几。其它的 js 文件均为针对某个 wcm 对象自身的操作，比如：乎所有的菜单项website.js 包含了站点的新建和导入等操作。可以根据需要向这个目录添加新的 js 文件以便新的菜单项。1.1.2 菜单项时的 json 属性描述属性名类型说明typeString当前菜单项的类型，可选值为：checkItem复选类型的菜单项radioItem单选类型的菜单项dynamic需

3、要动态加载的菜单项，经常配合 items 属性使用separate菜单中的分割线其他值或无值普通菜单项keyString全局唯一的菜单标识，为必需属性descString菜单的显示内容，为必需属性parentString当前菜单项需要到的父菜单 key 信息，顶级菜单项可不包含此属性hotKeyString当前菜单项的快捷键，仅对顶级菜单项有效1.1.3 菜单项示例说明效果限：无权限：代码reg(key : autoinfor,效果代码reg(key : BZ,desc : wcm.LANGSYS_38 | 帮助, hotKey : H,order : 9);说明reg 是前面定义的一个菜单函

4、数；此处表示了一个“帮助”菜单项； BZ 为全局唯一的标识信息；wcm.LANG 为多语言支持而定义的变量，二次开发时一般可以不考虑，只需要写上后面的“帮助”汉字即可，所以后面的示例，将不再带上此属性；hotKey 是为该菜单项定义的快捷键，表示按下 Alt+H 键将显示此帮助菜单的子菜单项；order 表示“帮助”菜单项将出现在菜单组的第九位orderNumber当前菜单项在父菜单项下出现的顺序，为可选属性，默认添加到当前父菜单下项最后面itemsArray/Function如果当前菜单项为普通菜单项，则表示该菜单项下的子菜单项，items 为子菜单项的 json 数组；如果当前菜单项为 d

5、ynamic 菜单项，items 表示需要动态加载的同级菜单项；clsFunction显示菜单之前给当前菜单项动态添加的样式，系统默认提供了样式checkItem（多选）、radioItem(单选)、disabled（菜单灰化），可根据需要使用自定义样式。如：某些菜单项在普通用户登录时，添加 disabled 样式，以让该菜单失效cmdFunction单击当前菜单项时，执行的处理函数，函数参数为：wcmEvent当前列表页面加载完成时，向操作面板发送的 event 对象，可从中获取列表页面中当前选中的对象个数及对象信息ode当前单击操作所单击的菜单项的 dom节点当前 this 上下文为该菜单

6、项的 item 自身效果代码reg(key : CZRW,desc : 操作任务,hotKey : O, order : 2, items: key : add, desc : 新建, order : 1,key : import,desc : 导入, order : 2,key : export,desc : 导出, order : 3,type : separate, order : 4,desc : 智能信息处理选件, parent : XJ,order : 3,cmd : function(event) skipTo(Path:autoInfor,0);,cls : function(

7、event,ode) var dom = Ext.fly(ode);domhasOperRight(autoInfor) ? addClass : removeClass(disabled););说明此处表示了一个“智能信息处理选件”菜单项；parent 表示将该菜单项注册到“选件”菜单项下（因为“XJ”是选件菜单项的唯一标识）；cmd 表示单击该菜单项时执行的处理，此处的 skipTo 函数调用的效果是弹出一个 wcm65的控制管理页面；cls 函数用来在菜单显示之前给菜单项动态添加的样式，此处在有智能信息处理选件权限时，移除了菜单项的 disabled 样式，否则添加了该样式，disabl

8、ed 是系统默认自带的样式，当有此样式时，单击菜单项将失效，即不执行它的 cmd 处理，当然你也完全可以在此处为菜单添加自己定义的样式，如：在此处将菜单项的字体变成红色等1.2 实战：如何修改或添加一个顶部菜单项1.2.1 如何修改一个已有的菜单项将“帮助”下的“1） 由于菜单的 文件中，所以反馈”菜单项改成“都在wcm/app/js/data/可以尝试先在 sys反馈定制”，同时字体变成“红色”的都在 sys.js目录下，同时.js 搜索“反馈”或将搜索范围固定在目录，找到相应的项；2） 修改相应项，请对比下面修改前后的变化，其中的粗体是修改过的部分修改前reg(key : backfeed

9、Online,desc : wcm.LANGSYS_39 | 反馈, parent : BZ,order : 1,cmd : function(event)window.open(.cn,.hostname + backfeedOnline););key : opers, type : dynamic, order : 5,items : function(event)/根据event 对象，返回需要动态添加的菜单项);说明此处表示 了“操作任务”菜单项；items 表示给“操作任务”菜单项添加了“新建”、“导入”等子菜单项，之所以“新建”等菜单项还会有子菜单项，是因为后面对它们又 了子菜单项

10、1.2.2 如何添加一个菜单项在“帮助”菜单项下，添加一个到“”的，并且只有当前用户是“管理员”时才能正确到“”，否则单击无效1)在 wcm/app/js/data/目录下添加一个 js 文件，并取一个适当名称，如：extend.js（wcm65 的版本分为开发版本和发布版本，在 wcm65 的开发版本，wcm 默认会加载目录下的所有文件，所以对开发版本而言此处添加的 js 文件在再次wcm 时会自动加载；发布版本需要运行一个 jsp 以生成合并之后的 js，见步骤 3。两种版本下均不需要再在页面种引入刚添加的 js 文件）在 extend.js 文件中添加如下 js 代码，注意将文件编码设置

11、为 utf-82)代码(function()var reg = wcm.View.register.bind(wcm.View); reg(key : baidu,desc : ,parent : BZ, order : 4,修改后reg(key : backfeedOnline, desc : 反馈定制,parent : BZ,order : 1,cls : function(event,ode) ode.style.color = red;,cmd : function(event)window.open(.cn,.hostname + backfeedOnline););3)无需重启，只

12、需要运行下./ wcm / wcm_use 目录下的wcm61_gen_runtime.jsp，合并 js 即可。刷新 wcm 页面再次，即可看到上面的效果。cls : function(event,ode)var isAdmin = wcm.AuthServer.isAdmin(); var sMethod = isAdmin ? removeClass :addClass;Ext.fly(ode)sMethod(disabled);,cmd : function(event)window.open(ht););)();说明a) (function()/)();表示一个执行体，和普通的执行语句没 大的区别，此处只是为了产生一个外界不能 的作用域将变量 reg 定义为一个函数，reg 其实和函数 wcm. View.register 的作用完全相同，此处只是为了使用一个简洁的函数名程调用 reg 函数，并将定义的菜单配置 json 作为参数函数 cls 中