30.54. <w:separator>

Separator构件用于在菜单中隔离不同分组的菜单项,Separator会在菜单中显示为凹下去的一条水平线。也可以用于在工具条中隔离不同分组的其它控件,此时Separator会在工具条中显示为凹下去的一条垂直线。Separator构件一般作为Menu的子构件(w:separator必须内嵌在w:menu中)使用或做为工具条(w:separator必须内嵌在w:toolBar或w:pagingToolBar中)的子构件使用。

30.54.1. 构件信息

表 30.131. 构件信息

Component Typeorg.operamasks.faces.component.widget.UISeparator
Component Familyorg.operamasks.faces.widget.Separator
Component Classorg.operamasks.faces.component.widget.UISeparator
Tag Classorg.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.54.2. 属性

表 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;样式

30.54.3. 构件API

30.54.4. 示例

<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将菜单项"关闭"同其它菜单项隔离开。