webuijsf
Tag propertySheet


Use the webuijsf:propertySheet tag to create a layout container for a property sheet. A property sheet is a content page that shows an object's properties and allows the user to edit the properties.

The webuijsf:propertySheet tag is a naming container for webuijsf:propertySheetSection tags. The webuijsf:propertySheetSection tag is a container for code>webuijsf:property tags, which define properties to be displayed with input or read-only components. The three property sheet tags are used to construct a property sheet that has a defined layout with sections.

A property sheet should contain one webuijsf:propertySheet tag and one or more webuijsf:propertSheetSection tags, each containing any number of webuijsf:property tags.

You might find it useful to place the webuijsf:propertySheet tag within the webuijsf:contentPageTitle tag to include a title and page controls for the property sheet.

HTML Elements and Layout

The propertySheet component functions mostly as a container and is rendered with an XHTML <div> element. The component can also be configured to render <a> hyperlink elements to create jump links in the page by setting the webuijsf:propertySheet tag's jumpLinks attribute to true. The links provide a quick way for the user to jump to each section in the page. The text of the jump links includes the section label text, if specified in the webuijsf:propertySheetSection tags. Additional links for jumping back to the top of the page are rendered at the end of each section.

Client Side Javascript Functions

None.

Examples

Example 1: A simple property sheet that contains two property sheet sections

This example shows a property sheet with jump links and a required field legend.

	<webuijsf:propertySheet id="propSheetExample1" jumpLinks="true" requiredFields="true" >
	    <webuijsf:propertySheetSection id="firstSection" label="Search Criteria">
		<webuijsf:property id="Property1" label="Instance Name: " labelAlign="right" noWrap="true" overlapLabel="false">
		    <webuijsf:dropDown id="servers" required="true" items="#{BackingFileChoice.servers}" />
		    <f:verbatim>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</f:verbatim>
		    <webuijsf:label id="logFileLabel" labelLevel="2" text="Log File: " />
		    <webuijsf:dropDown id="logFile" items="#{BackingFileChoice.archivedLogFiles}" />
		</webuijsf:property>
		<webuijsf:property id="Property2" label="Log Level: " labelAlign="right" noWrap="true" overlapLabel="false" helpText="#{bundle.['log.level.help']}">
		    <f:facet name="content">
			<webuijsf:dropDown id="logLevel" items="#{BackingFileChoice.logLevel}" />
		    </f:facet>
		</webuijsf:property>
	    </webuijsf:propertySheetSection>
	    <webuijsf:propertySheetSection id="secondSection" label="Advanced Options">
		<webuijsf:property id="Property3" label="Logger: " labelAlign="right" noWrap="true" overlapLabel="false" helpText="Select one or more module logs to view">
		    <webuijsf:listbox id="logger" items="#{BackingFileChoice.loggers}" rows="5" />
		</webuijsf:property>
		<webuijsf:property id="Property4" noWrap="true" overlapLabel="false" helpText="Select one or more module logs to view">
		    <webuijsf:checkbox id="limitLongLogs" label="Limit excessively long messages" />
		</webuijsf:property>
	    </webuijsf:propertySheetSection>
	</webuijsf:propertySheet>
    



Tag Information
Tag Classcom.sun.webui.jsf.component.PropertySheetTag
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.
styleClassfalsefalsejava.lang.String

CSS style class(es) to be applied to the outermost HTML element when this component is rendered.

requiredFieldsfalsefalsejava.lang.String

Specifies whether to display a required field legend in the upper right area of the property sheet. This attribute should be set to true if one or more properties in the property sheet sections are marked required.

jumpLinksfalsefalsejava.lang.String

This boolean attribute allows you to control whether jump links will be created at the top of this PropertySheet or not. The default is NOT to create the links -- setting this attribute to "true" turns this feature on.

visiblefalsefalsejava.lang.String

Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. If set to false, the HTML code for the component is present in the page, but the component is hidden with style attributes. By default, visible is set to true, so HTML for the component HTML is included and visible to the user. If the component is not visible, it can still be processed on subsequent form submissions because the HTML is present.

stylefalsefalsejava.lang.String

CSS style(s) to be applied to the outermost HTML element when this component is rendered.

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.