struts-menu 简介

SECTION 01 struts-menu 简介





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

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

SimpleMenuDisplayer

DropDownMenuDisplayer

CoolMenuDisplayer

CoolMenuDisplayer4

ListMenuDisplayer

TabbedMenuDisplayer

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

SECTION 02 struts-menu 的安装

将 /lib/struts-menu.jar 放到 WEB-INF/lib/ 之下

将 /lib/struts-menu.tld 放到 WEB-INF/lib/ 之下

修改 web.xml 加入 taglib 的调用

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

你的 jsp 程序需要加入.

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

修改你的 WEB-INF/struts-config.xml, 在最后加入 plugin

<plug-in className="com.fgm.web.menu.MenuPlugIn">
<set-property property="menuConfig" value="/WEB-INF/menu-config.xml"/>
</plug-in>

建立 /WEB-INF/menu-config.xml 作为 Menu 的配置文件, 以下 是范例文件

<?xml version="1.0"

encoding="UTF-8" ?>

<MenuConfig>
<Displayers>
<Displayer   name="DropDown"
type="com.fgm.web.menu.displayer.DropDownMenuDisplayer"/>
<Displayer   name="Simple"
type="com.fgm.web.menu.displayer.SimpleMenuDisplayer"/>
<Displayer   name="CoolMenu"
type="com.fgm.web.menu.displayer.CoolMenuDisplayer"/>
<Displayer   name="CoolMenu4"
type="com.fgm.web.menu.displayer.CoolMenuDisplayer4"/>
<Displayer   name="MenuForm"
type="com.fgm.web.menu.example.PermissionsFormMenuDisplayer

"/>
<Displayer   name="ListMenu"
type="com.fgm.web.menu.displayer.ListMenuDisplayer"/>
<Displayer   name="TabbedMenu"
type="com.fgm.web.menu.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, 将可以将 menu-config.xml 的配置的选单组件显示出來. 如果是多层的状况,也会內缩样式呈现.

<%@ 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 开发的梦想, 将会到來...