Separator构件用于在菜单中隔离不同分组的菜单项,Separator会在菜单中显示为凹下去的一条水平线。也可以用于在工具条中隔离不同分组的其它控件,此时Separator会在工具条中显示为凹下去的一条垂直线。Separator构件一般作为Menu的子构件(w:separator必须内嵌在w:menu中)使用或做为工具条(w:separator必须内嵌在w:toolBar或w:pagingToolBar中)的子构件使用。
表 30.131. 构件信息
| Component Type | org.operamasks.faces.component.widget.UISeparator |
| Component Family | org.operamasks.faces.widget.Separator |
| Component Class | org.operamasks.faces.component.widget.UISeparator |
| Tag Class | org.operamasks.faces.webapp.widget.UISeparatorTag |
| Renderer Type(DEFAULT) | org.operamasks.faces.component.widget.UISeparator |
| Renderer Type(MENU) | org.operamasks.faces.component.widget.UIMenuSeparator |
| Renderer Class(AJAX DEFAULT) | org.operamasks.faces.render.widget.ajax.AjaxSeparatorRenderer |
| Renderer Class(AJAX MENU) | org.operamasks.faces.render.widget.ajax.AjaxMenuSeparatorRenderer |
+java.lang.Object
++javax.faces.component.UIComponent
+++javax.faces.component.UIComponentBase
++++org.operamasks.faces.component.widget.base.UISeparatorBase
+++++org.operamasks.faces.component.widget.UISeparator
表 30.132. 属性
| binding | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | javax.el.ValueExpression(javax.faces.component.UIComponent) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个值表达式,用于把该组件链接到一个ManagedBean的某个属性。 | ||||
| id | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内,必须是唯一的。 | ||||
| rendered | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | boolean(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个标志,指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。 | ||||
| style | 定义类 | org.operamasks.faces.component.widget.UISeparator | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件渲染时应用到构件的CSS风格,对应于元素的style属性,IE8不支持color:blue;样式 | ||||
| styleClass | 定义类 | org.operamasks.faces.component.widget.UISeparator | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 空格分隔的CSS风格类名列表,渲染时作为元素的"class"属性,IE8不支持color:blue;样式 | ||||
<w:menu label="文件">
<w:menu image="images/new.gif" label="新建" />
<w:commandMenuItem image="images/open.gif" label="打开..."/>
<w:commandMenuItem image="images/save.gif" label="保存"/>
<w:commandMenuItem label="另存为..." disabled="true"/>
<w:separator/>
<w:linkMenuItem label="关闭" value="../index.html" onclick="return confirm('Are you sure?')"/>
</w:menu>以上代码用一个w:separator将菜单项"关闭"同其它菜单项隔离开。