StrutsMenu简介

StrutsMenu简介

目前版本 1.3, 由此下载 binary/source 文件


在网页开发的时候,我们常常需要用到一些选单（选 择菜单）, 可能是下拉选单, 可能是标签式选单, 可能是树状选单, struts-menu, 帮我们实现了一些常用的选单, 可以 节省我们开发的的时间, 目前提供的有以下几种.

• SimpleMenuDisplayer
• DropDownMenuDisplayer
• CoolMenuDisplayer
• CoolMenuDisplayer4
• ListMenuDisplayer
• TabbedMenuDisplayer

让我们先来安装 struts-menu 的范例, 你可以在解压缩的目录中找到一个 struts-menu.war 的文件, 将他放到 %TOMCAT_HOME%/webapps/ 之下, 接着使用 localhost:8080/struts-menu/ 就可以看到了.


SECTION 02 struts-menu 的安装

1. 将 /lib/struts-menu.jar 放到 WEB-INF/lib/ 之下
2. 将 /lib/struts-menu.tld 放到 WEB-INF/lib/ 之下
3. 修改 l 加入 taglib 的调用

   <taglib><taglib-uri>/WEB-INF/struts-menu.tld</taglib-uri><taglib-location>/WEB-INF/struts-menu.tld</taglib-location>
   </taglib>
   

4. 你的 jsp 程序需要加入.

   <%@ taglib uri="/WEB-INF/struts-menu.tld" prefix="menu" %>
   

5. 修改你的 l, 在最后加入 plugin

   <plug-in className="com.u.MenuPlugIn"><set-property property="menuConfig" value="/l"/>
   </plug-in>
   

6. 建立 /l 作为 Menu 的配置文件, 以下 是范例文件

   <?xml version="1.0" encoding="UTF-8" ?><MenuConfig><Displayers><Displayer   name="DropDown"
                    type="com.u.displayer.DropDownMenuDisplayer"/><Displayer   name="Simple"
                    type="com.u.displayer.SimpleMenuDisplayer"/><Displayer   name="CoolMenu"
                    type="com.u.displayer.CoolMenuDisplayer"/><Displayer   name="CoolMenu4"
                    type="com.u.displayer.CoolMenuDisplayer4"/><Displayer   name="MenuForm"
                    type="com.u.example.PermissionsFormMenuDisplayer"/><Displayer   name="ListMenu"
                    type="com.u.displayer.ListMenuDisplayer"/><Displayer   name="TabbedMenu"
                    type="com.u.displayer.TabbedMenuDisplayer"/></Displayers><Menus><Menu  name="indexMenu"  title="Examples"><Item  name="indexMenu1"  title="Basic Example"  
                  toolTip="Shows usage of the menu displayers using defaults."
                  page="/menutest1.jsp"/><Item  name="indexMenu2"  title="Advanced Example"
                  toolTip="Shows customized menu displays."
                  page="/menutest2.jsp"/><Item  name="indexMenu3"  title="CoolMenu Example"
                  toolTip="Shows menu using CoolMenu3"
                  page="/coolmenu1.jsp"/><Item  name="indexMenu4"  title="CoolMenu Example - With Form"
                   toolTip="Shows menu using CoolMenu3 with forms."
                  page="/coolmenu2.jsp"/><Item  name="indexMenu5"  title="Permissions Example"
                   toolTip="Example use of menu disable and permission checking with CoolMenus."
                  page="/permissionsForm.jsp"/><Item  name="indexMenu6"  title="CoolMenu4 Example"
                  toolTip="Shows menu using CoolMenu4"
                  page="/coolmenu4.jsp"/><Item  name="indexMenu7"  title="Expandable DHTML List Example"
                  toolTip="Shows Expandable DHTML list"
                  page="/dhtmlExpandable.jsp"/><Item  name="indexMenu7"  title="Dropdown DHTML List Example"
                  toolTip="Shows Dropdown DHTML list"
                  page="/dhtmlDropdown.jsp"/><Item  name="indexMenu8"  title="Roles Menu Example"
                  toolTip="Shows Menus based on user's role"
                  page="/rolesMenu.jsp"/><Item  name="indexMenu9"  title="Tabbed Menu Example [New!]"
                  toolTip="Shows Tabbed-based Menu"
                  forward="tabbedMenu"/></Menu>
   </MenuConfig>    
   

SECTION 03 基本型选单 - SimpleMenuDisplayer 的 taglib 使用方法

我们可以简单的使用 menu:useMenuDisplayer name="Simple" 去调用 SimpleMenuDisplayer, 接着指定 menu:displayMenu 指定 indexMenu, 将可以将 l 的配置的选单组件显示出來. 如果是多层的状况,也会內缩样式呈现.

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib uri="/WEB-INF/struts-menu.tld" prefix="menu"%>
<menu:useMenuDisplayer name="Simple"><menu:displayMenu name="indexMenu"/>
</menu:useMenuDisplayer>

SECTION 04 下拉型选单 - DropDownMenuDisplayer 的 taglib 使用方法

下拉型选单, 就是可以展开及关闭,使用的方法与 SimpleMenuDisplayer 雷同,只需要改成 menu:useMenuDisplayer name="DropDown" 就 可以了.


SECTION 05 浮动式选单 - CoolMenuDisplayer 的 taglib 使用方法

浮动式选单除了需要改成 menu:useMenuDisplayer name="CoolMenu" 或 "CoolMenu4" 可以了. CoolMenu 还需要取得 javascript coolmenu3.js, CoolMenu4 则是需要取得 javascript coolmenu4.js 及 cm_addins.js, 并且要配置相关的 coolmenu-config.js, 你可以配置他显示的图形及 颜色等等.


SECTION 06 树状选单 - ListMenuDisplayer 的 taglib 使用方法

树状选单则是把 menu:useMenuDisplayer name 设为 "ListMenu". 可以加入 menuExpandable.js, 调用 expandMenus() 将所有子节点显 示出來.


SECTION 07 标签选单 - TabbedMenuDisplayer 的 taglib 使用方法

标签选单將 menu:useMenuDisplayer name 设为 "TabbedMenu",并且 加入 tabs.js 即可,


SECTION 08 结论

struts-menu 还可以和 permission , role 结合, 让具有该权限的使用者才能够看到及使用那些选项, 有兴趣的可以参 考范例, 我想, 台湾孙三才先生的 jspwidget 的 taglib 组件设计风格 更吸引人, 如果能够结合这两项, 并且修改为各种浏览器都可以正常浏览, 那么 web ui-component 开发的梦想, 将会到來...