30.41. <w:page>

Page代表一个JSF页面，是一个容器，里面可以放任意构件，可以把它看成是HTML页面的一个抽象，最终生成的还是 <html>、<head>、<body>等代码。此构件负责统一渲染页面的初始化脚本，建议所有页面均应使用此构件。

30.41.1. 构件信息

表 30.104. 构件信息

Component Type	org.operamasks.faces.HtmlPage
Component Family	org.operamasks.faces.HtmlDocument
Component Class	org.operamasks.faces.component.html.HtmlPage
Tag Class	org.operamasks.faces.webapp.widget.HtmlPageTag
Renderer Type	org.operamasks.faces.HtmlPage
Renderer Class(AJAX)	org.operamasks.faces.render.widget.ajax.AjaxPageRenderer

继承体系

+java.lang.Object

++javax.faces.component.UIComponent

+++javax.faces.component.UIComponentBase

++++org.operamasks.faces.component.html.HtmlPageBase

+++++org.operamasks.faces.component.html.HtmlPage

30.41.2. 属性

表 30.105. 属性

bgcolor	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	页面的背景颜色
binding	定义类	javax.faces.component.UIComponentBase
	类型	javax.el.ValueExpression(javax.faces.component.UIComponent)
	是否必须	否	延时求值	是
	一个值表达式，用于把该组件链接到一个ManagedBean的某个属性。
dir	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	文本的阅读方向，可选值有LTR(从左至右)和RTL(从右至左)
duration	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	loadMask属性持续的时间，单位是秒
id	定义类	javax.faces.component.UIComponentBase
	类型	java.lang.String
	是否必须	否	延时求值	否
	这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内，必须是唯一的。
lang	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	属性值和文本内容所使用的语言
loadMask	定义类	org.operamasks.faces.component.html.HtmlPageBase
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否有页面加载标识，可以提高用户体验
loadMaskText	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	loadMask中显示的文字信息。默认为'Loading...'
onload	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	当页面加载的时候执行的JavaScript代码
onunload	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	当页面卸载的时候执行的JavaScript代码
rendered	定义类	javax.faces.component.UIComponentBase
	类型	boolean(boolean)
	是否必须	否	延时求值	是
	一个标志，指出该组件是否要在任何随后的form提交过程中被渲染或处理。这个属性的缺省值是true。
skin	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	配置页面的皮肤，默认为default
style	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件渲染时应用到构件的CSS风格，对应于元素的style属性
styleClass	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	空格分隔的CSS风格类名列表，渲染时作为元素的"class"属性
title	定义类	org.operamasks.faces.component.html.HtmlPage
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	为构件提供的提示信息

30.41.3. 构件API

30.41.4. 示例

下面是w:page的用法，标题是"This is title"，页面使用的皮肤是"vista"，当页面加载的时候出现加载提示框，动画效果持续3秒钟。

<w:page title="This is title!" skin="vista" loadMask="true" duration="3">
    <w:button value="Button" />
</w:page>

上一页	起始页	下一页
30.40. <w:outputColumn>		30.42. <w:pagingLink>