webuijsf
Tag page


Use the webuijsf:page tag to indicate the beginning of the part of the JSP page that is used by the Sun Java Web UI Components. All the JSF components used in the page must be nested within the webuijsf:page tag. You must use the webuijsf:html and webuijsf:head tags first, after the opening of the webuijsf:page tag.  Then you must use either the webuijsf:body tag or the webuijsf:frameset tag.  The webuijsf:page tag takes care of generating the preamble for the HTML page.

HTML Elements and Layout

If the application is used in a portlet environment, nothing is rendered for the webuijsf:page tag but it is still necessary to include it.

If the application is used in a servlet environment, the rendered HTML will include <?xml> and <!DOCTYPE> headers. The content of the headers is determined by the webuijsf:page attributes that you specify.  Use the frameset and xhtml attributes to create the <!DOCTYPE> header that you want.  For example, if you set frameset and xhtml attributes to true, the rendered <!DOCTYPE> header will indicate XHTML Frameset, as in the following example:

<!DOCTYPE HTML 
PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">

If you set both attributes to false,  the rendered <!DOCTYPE> header will indicate HTML Transitional,  as in the following example:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

You can also use the frameset and xhtml attributes to specify  XHTML Transitional and HTML Frameset.

Client Side Javascript Functions

None.

Example

Example 1: Using the page tag appropriately in a JSP page:

<?xml version="1.0" encoding="UTF-8"?>
<jsp:root version="1.2" xmlns:f="http://java.sun.com/jsf/core" xmlns:h="http://java.sun.com/jsf/html" xmlns:jsp="http://java.sun.com/JSP/Page" xmlns:webuijsf="http://www.sun.com/web/webuijsf">
<jsp:directive.page contentType="text/html;charset=ISO-8859-1" pageEncoding="UTF-8"/>
<f:view>
  <webuijsf:page>
    <webuijsf:html>
       ......
    <
/webuijsf:html>
  </webuijsf:page>
</f:view>


Tag Information
Tag Classcom.sun.webui.jsf.component.PageTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingfalsefalsejava.lang.String A ValueExpression that resolves to the UIComponent that corresponds to this tag. This attribute allows the Java bean that contains the UIComponent to manipulate the UIComponent, its properties, and its children.
xhtmlfalsefalsejava.lang.String XHTML transitional page or HTML transitional page. This attribute influences the rendering of the <!DOCTYPE> attribute. If xhtml is true, the <!DOCTYPE> will be one of the following, depending on the setting of frameset attribute.
<!DOCTYPE html 
PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd"
<!DOCTYPE html 
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
framefalsefalsejava.lang.String Use the frame attribute to indicate whether the page should render frames. If this attribute is true, the rendered HTML page includes a <frameset> element. If false, the rendered page uses a <body> tag.  This attribute also influences the rendering of the <!DOCTYPE> attribute. If frameset is true, the <!DOCTYPE> will be one of the following, depending on the setting of xhtml attribute.
<!DOCTYPE html 
PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">

<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
"http://www.w3.org/TR/html4/DTD/frameset.dtd">
renderedfalsefalsejava.lang.String Use the rendered attribute to indicate whether the HTML code for the component should be included in the rendered HTML page. If set to false, the rendered HTML page does not include the HTML for the component. If the component is not rendered, it is also not processed on any subsequent form submission.
idfalsetruejava.lang.StringNo Description

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.