LinkMenuItem是一个带链接的菜单项,点击LinkMenuItem类型的菜单项会导航到指定的URL。LinkMenuItem必须作为Menu的子构件(w:linkMenuItem必须内嵌在w:menu中)使用,关于更多如何使用Menu的信息,请阅读Menu的构件参考。
表 30.84. 构件信息
| Component Type | org.operamasks.faces.widget.LinkMenuItem |
| Component Family | javax.faces.Output |
| Component Class | org.operamasks.faces.component.widget.menu.UILinkMenuItem |
| Tag Class | org.operamasks.faces.webapp.widget.UILinkMenuItemTag |
| Renderer Type | org.operamasks.faces.widget.UILinkMenuItem |
| Renderer Class(AJAX) | org.operamasks.faces.render.widget.ajax.AjaxLinkMenuItemRenderer |
+java.lang.Object
++javax.faces.component.UIComponent
+++javax.faces.component.UIComponentBase
++++javax.faces.component.UIOutput
+++++javax.faces.component.html.HtmlOutputLink
++++++org.operamasks.faces.component.widget.menu.base.UILinkMenuItemBase
+++++++org.operamasks.faces.component.widget.menu.UILinkMenuItem
表 30.85. 属性
| activeClass | 定义类 | org.operamasks.faces.component.widget.menu.UILinkMenuItem | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件激活状态时的css样式 | ||||
| binding | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | javax.el.ValueExpression(javax.faces.component.UIComponent) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个值表达式,用于把该组件链接到一个ManagedBean的某个属性。 | ||||
| converter | 定义类 | javax.faces.component.UIOutput | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 构件注册的转换器 | ||||
| disabled | 定义类 | org.operamasks.faces.component.widget.menu.UILinkMenuItem | ||
| 类型 | javax.el.ValueExpression(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 指定构件是否可用 | ||||
| disabledClass | 定义类 | org.operamasks.faces.component.widget.menu.UILinkMenuItem | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件不可用状态时的css样式 | ||||
| id | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内,必须是唯一的。 | ||||
| image | 定义类 | org.operamasks.faces.component.widget.menu.UILinkMenuItem | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 菜单项显示的图标 | ||||
| label | 定义类 | org.operamasks.faces.component.widget.menu.UILinkMenuItem | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 菜单项显示的文本 | ||||
| onclick | 定义类 | javax.faces.component.html.HtmlOutputLink | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 构件被点击时执行的Javascript代码 | ||||
| rendered | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | boolean(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个标志,指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。 | ||||
| style | 定义类 | javax.faces.component.html.HtmlOutputLink | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件渲染时应用到构件的CSS风格,对应于元素的style属性 | ||||
| styleClass | 定义类 | javax.faces.component.html.HtmlOutputLink | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 空格分隔的CSS风格类名列表,渲染时作为元素的"class"属性 | ||||
| target | 定义类 | javax.faces.component.html.HtmlOutputLink | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 指定在哪个窗口或框架中加载被链接文档 | ||||
| value | 定义类 | javax.faces.component.UIOutput | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 构件的当前值 | ||||
以上代码在"链接"菜单中定义两个LinkMenuItem,分别链接到http://www.operamasks.org和http://java.sun.com。
<w:menuBar>
<w:menu label="链接">
<w:linkMenuItem label="Operamasks Community" value="http://www.operamasks.org" target="_new"/>
<w:linkMenuItem label="Java Home" value="http://java.sun.com" target="_new"/>
</w:menu>
<w:menuBar>