PanelBox构件通常被用作为一个有边框的容器,用于装饰的目的。
表 30.111. 构件信息
| Component Type | org.operamasks.faces.component.widget.UIPanelBox |
| Component Family | javax.faces.Panel |
| Component Class | org.operamasks.faces.component.widget.UIPanelBox |
| Tag Class | org.operamasks.faces.webapp.widget.UIPanelBoxTag |
| Renderer Type | org.operamasks.faces.component.widget.UIPanelBox |
| Renderer Class(AJAX) | org.operamasks.faces.render.widget.ajax.AjaxPanelBoxRenderer |
+java.lang.Object
++javax.faces.component.UIComponent
+++javax.faces.component.UIComponentBase
++++javax.faces.component.UIPanel
+++++org.operamasks.faces.component.widget.base.UIPanelBoxBase
++++++org.operamasks.faces.component.widget.UIPanelBox
表 30.112. 属性
| bgcolor | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 背景颜色 | ||||
| binding | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | javax.el.ValueExpression(javax.faces.component.UIComponent) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个值表达式,用于把该组件链接到一个ManagedBean的某个属性。 | ||||
| border | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 边框的宽度 | ||||
| borderColor | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 边框的颜色 | ||||
| borderRadius | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 边框圆角的半径 | ||||
| color | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 前端渐变颜色1 | ||||
| color2 | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 前端渐变颜色2 | ||||
| color3 | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 前端渐变颜色3 | ||||
| contentStyle | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 内容的css样式 | ||||
| contentStyleClass | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 内容的css样式类 | ||||
| gradientExtent | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.Integer) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 渐变效果的长度 | ||||
| id | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | java.lang.String | |||
| 是否必须 | 否 | 延时求值 | 否 | |
| 这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内,必须是唯一的。 | ||||
| rendered | 定义类 | javax.faces.component.UIComponentBase | ||
| 类型 | boolean(boolean) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 一个标志,指出该组件是否要在任何随后的form提交过程中被渲染或处理。 这个属性的缺省值是true。 | ||||
| roundedCorners | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 圆角的位置,例如"tl,tr",代表左上角和右上角都采用圆角 | ||||
| style | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 构件渲染时应用到构件的CSS风格,对应于元素的style属性 | ||||
| styleClass | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 空格分隔的CSS风格类名列表,渲染时作为元素的"class"属性 | ||||
| uniqueClass | 定义类 | org.operamasks.faces.component.widget.UIPanelBox | ||
| 类型 | javax.el.ValueExpression(java.lang.String) | |||
| 是否必须 | 否 | 延时求值 | 是 | |
| 唯一对应该构件的一个CSS风格类名,起限定作用,除非特殊情况,一般不需要用户设定。如果不设定,在渲染时系统会自行指定一个不重复的值 | ||||
这个示例来自 bpdemos,用w:panelBox作为背景框来显示一段文字:
<w:panelBox style="width:394px" bgcolor="#FFFFFF">
<h3>Lorem ipsum</h3>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis ornare ultricies libero.
Donec fringilla, eros at dapibus fermentum, tellus tellus auctor erat, vitae porta magna libero
sed libero. Mauris sed leo. Aliquam aliquam. Maecenas vestibulum.</p>
</w:panelBox>
<w:panelBox style="width:394px" bgcolor="#FFFFFF" styleClass="x-box-blue">
<h3>Lorem ipsum</h3>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis ornare ultricies libero.
Donec fringilla, eros at dapibus fermentum, tellus tellus auctor erat, vitae porta magna libero
sed libero. Mauris sed leo. Aliquam aliquam. Maecenas vestibulum.</p>
</w:panelBox>上面是传统的长方形的框,还可以是圆形的,通过"borderRadius"属性来设置半径,代码如下:
<w:panelBox id="sphere" border="0" borderColor="silver" borderRadius="110" color="white"
color2="gray" gradientExtent="110" bgcolor="#FFFFFF">
<em>Sphere said</em>: I'm a shpere.<br />
<em>Box service said</em>: No, you're a box.<br />
<em>Sphere</em>: ......!? I don't think so.
</w:panelBox>