31.13. <layout:tabLayout>

TabLayout是一个标签页面板，作为一个放标签页的容器。

31.13.1. 构件信息

表 31.30. 构件信息

Component Type	org.operamasks.faces.component.layout.impl.UITabLayout
Component Family	org.operamasks.faces.component.layout.impl.UIPanel
Component Class	org.operamasks.faces.component.layout.impl.UITabLayout
Tag Class	org.operamasks.faces.webapp.layout.UITabLayoutTag
Renderer Type	org.operamasks.faces.component.layout.impl.UITabLayout
Renderer Class(AJAX)	org.operamasks.faces.render.layout.ajax.AjaxTabLayoutRenderer

继承体系

+java.lang.Object

++javax.faces.component.UIComponent

+++javax.faces.component.UIComponentBase

++++org.operamasks.faces.component.layout.base.UIPanelBase

+++++org.operamasks.faces.component.layout.impl.UIPanel

++++++org.operamasks.faces.component.layout.impl.UILayout

+++++++org.operamasks.faces.component.layout.base.UITabLayoutBase

++++++++org.operamasks.faces.component.layout.impl.UITabLayout

31.13.2. 属性

表 31.31. 属性

activeTab	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	当前处于激活状态的tab页的序号
animCollapse	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	在构件收缩时是否显示动画效果
animFloat	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许面板收缩/展开的激活. 当点击一个收缩区域的bar时，这个区域的面板就会显示成一个浮动的面板，并且当鼠标移开该区域（或者在autoHide被设置成false时，点击面板外的地方）时，面板会收缩。把animFloat设置成false可以阻止面板收缩/展开的激活 (默认值：true)
animScroll	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否动画显示Tab页的滚动(默认值：true), 只在enableTabScroll为true时有效
autoHeight	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许构件自适应高度(默认值： false).
autoHide	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	鼠标移开浮动面板时面板是否自动收缩 (默认值：true)
autoWidth	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许构件自适应宽度 (默认值：false)
binding	定义类	javax.faces.component.UIComponentBase
	类型	javax.el.ValueExpression(javax.faces.component.UIComponent)
	是否必须	否	延时求值	是
	一个值表达式，用于把该组件链接到一个ManagedBean的某个属性。
bodyStyle	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	容器内元素使用的CSS样式
border	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否显示面板body元素的边框(默认值：true)。默认情况下，边框是一个2px宽的内嵌边框，但当bodyBorder属性被设置成false时可以进一步修改
colspan	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	构件占据的列数
columnWidth	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Float)
	是否必须	否	延时求值	是
	构件宽度的百分比小数值
deferredRender	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否在tab激活时进行渲染(默认值：true)
enableTabScroll	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许tab很多时滚动以显示隐藏的tab(默认值：false)
fit	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件是否充满父容器
floating	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	面板是否漂浮 (默认值：false)
height	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件高度的像素值 (默认是auto)
hideBorders	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否隐藏边框。为true时隐藏内部构件的边框, 为false时适应内部构件的边框设置 (默认值：false).
id	定义类	javax.faces.component.UIComponentBase
	类型	java.lang.String
	是否必须	否	延时求值	否
	这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内，必须是唯一的。
initConfig	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Object)
	是否必须	否	延时求值	是
	初始化配置对象。取值可以是ExtConfig对象, 或String，表示一个JavaScript对象，比如:{"a": "avalue", "b":true, "c":200, "d":"var::dvalue"} 如果取值是表示一个JavaScript对象的String，则key必须用(双）引号包起来，比如"a"。
items	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.util.List)
	是否必须	否	延时求值	是
	tabLayout要加载的多个页签，类型为List，内部数据为FramePanel，渲染在静态的panel之后
jsvar	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	客户端脚本使用的javascript变量名
maskDisabled	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	在面板disabled时，是否用直观的方式标识 (默认值：true)
minTabWidth	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	当resizeTabs属性为ture时tab的最小宽度(默认值：30)
monitorResize	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否监视浏览器窗口的resize，并进行tab的resize(默认值：true).
onbeforeexpand	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件展开前执行的JavaScript代码
plain	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否不用背景容器图片渲染tab(默认值：false)
rendered	定义类	javax.faces.component.UIComponentBase
	类型	boolean(boolean)
	是否必须	否	延时求值	是
	一个标志，指出该组件是否要在任何随后的form提交过程中被渲染或处理。这个属性的缺省值是true。
resizeTabs	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许tab动态调整宽度以填充整个容器(默认值：false)
rowspan	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	构件占据的行数
scrollDuration	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Float)
	是否必须	否	延时求值	是
	每个滚动动画持续的时间(单位为毫秒, 默认是0.35). 只有当animScroll属性为true时生效.
scrollIncrement	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	当tab滚动按钮点击时滚动的长度(以像素为单位，默认是100像素或者当resizeTab属性等于true时为tab的宽度). 只有enableTabScroll属性为true时生效.
scrollRepeatInterval	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	当tab滚动按钮持续点击时两个滚动之间的时间间隔(单位为毫秒，默认为400)
shadow	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件是否显示阴影效果.该属性仅在floating属性被设置成true时有效
shadowOffset	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	阴影偏离的像素数 (默认值：4).该属性仅在floating属性被设置成true时有效
shim	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否在需要的时候enable内框架边界 (默认值：true). 该属性仅在floating属性被设置成true时有效
showTitleOnCollapse	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	在构件收缩后是否显示标题 (默认值：false). 注意：该属性仅在region="north"或者region="south"，属性被设置成true时有效
style	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件渲染时应用到构件的CSS风格，对应于元素的style属性
styleClass	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	空格分隔的CSS风格类名列表，渲染时作为元素的"class"属性
tabPosition	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	Tab标签渲染的位置(默认值： 'top')合法值有：top、bottom、left、right
tabWidth	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	新建Tab的标签的初始宽度(默认值：120)
toolBarPosition	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	内置工具栏的位置，可能的取值为"top","bottom",或"both"。
wheelIncrement	定义类	org.operamasks.faces.component.layout.impl.UITabLayout
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	当用鼠标滚轮滚动Tab页签时每次鼠标滚轮滚动的长度(单位为像素, 默认为20像素)
width	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件宽度的像素值 (默认是auto)
x	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	构件左边界距离父容器左边界的像素数
y	定义类	org.operamasks.faces.component.layout.impl.UIPanel
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	构件上边界距离父容器上边界的像素数

31.13.3. 构件API

31.13.3.1. UITabLayout(tabLayout的构件类)

表 31.32. 常用方法

addTab	方法签名	public void addTab(String title, String url, String iconClass)
	参数说明	title: 新增页面的标题。url: 新增页面的Url。iconClass: 新增页面的图标的CSS类
	返回值	无返回值
	方法描述	新增一页
addTabs	方法签名	public void addTabs(List items)
	参数说明	items，要添加的多个页签的配置，List内部数据类型为FramePanel
	返回值	无返回值
	方法描述	新增多个页签
setActiveTab	方法签名	public void setActiveTab(java.lang.Integer value)
	参数说明	激活的页签的编号
	返回值	无返回值
	方法描述	设置当前激活页

31.13.4. 示例

下面的例子是一个简单的tabLayout布局。

<layout:tabLayout height="400"> 
  <layout:panel title="tab1">tab1</layout:panel> 
  <layout:panel title="tab2">tab2</layout:panel> 
  <layout:panel title="tab3">tab3</layout:panel> 
</layout:tabLayout>

上一页	起始页	下一页
31.12. <layout:panelGrid>		31.14. <layout:tableLayout>