30.44. <w:panelBox>

PanelBox构件通常被用作为一个有边框的容器,用于装饰的目的。

30.44.1. 构件信息

表 30.111. 构件信息

Component Typeorg.operamasks.faces.component.widget.UIPanelBox
Component Familyjavax.faces.Panel
Component Classorg.operamasks.faces.component.widget.UIPanelBox
Tag Classorg.operamasks.faces.webapp.widget.UIPanelBoxTag
Renderer Typeorg.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.44.2. 属性

表 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风格类名,起限定作用,除非特殊情况,一般不需要用户设定。如果不设定,在渲染时系统会自行指定一个不重复的值

30.44.3. 构件API

30.44.4. 示例

这个示例来自 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>