webuijsf
Tag panelGroup


Use the webuijsf:panelGroup tag to display a group of components that are separated by a common separator. This is often useful for providing a consistently formatted layout of a group of components.

HTML Elements and Layout

The PanelGroup component defines and renders a group of components. The group of components are defined in the body of thewebuijsf:panelGroup tag, or by specifying children of the PanelGroup component. The child components do not have to be of like type. The separator is defined by the separator property, or the separator facet. The separator may be an empty string, a space, text / character(s), markup, or a component defined by the separator facet.

By default the PanelGroup component is rendered with a<span> surrounding the group of child components. This may be changed to a <div> by setting theblock property to true.

PanelGroup is a NamingContainer.

Theme Identifiers

Not Applicable

Client Side Javascript Functions

Not Applicable

Examples:

Example 1: Simple example showing 4 buttons using the default separator (a return character).

<webuijsf:panelGroup id="myPanelGroup1">
    <webuijsf:button id="button1" text="Button 1" />
    <webuijsf:button id="button2" text="Button 2" />
    <webuijsf:button id="button3" text="Button 3" />
    <webuijsf:button id="button4" text="Button 4" />
</webuijsf:panelGroup>

Example 2: Same example except using the separator attribute to specify '|' (pipe) as the separator.

<webuijsf:panelGroup id="myPanelGroup2" separator=" | ">
    <webuijsf:button id="button1" text="Button 1" />
    <webuijsf:button id="button2" text="Button 2" />
    <webuijsf:button id="button3" text="Button 3" />
    <webuijsf:button id="button4" text="Button 4" />
</webuijsf:panelGroup>

Example 3: Same example except using the separator facet to specify the separator. This example also demonstrates theblock property.

<webuijsf:panelGroup id="myPanelGroup3" block="true">
    <facet name="separator">
        <h:outputText value="==" />
    </f:facet>
    <webuijsf:button id="button1" text="Button 1" />
    <webuijsf:button id="button2" text="Button 2" />
    <webuijsf:button id="button3" text="Button 3" />
    <webuijsf:button id="button4" text="Button 4" />
</webuijsf:panelGroup>


Tag Information
Tag Classcom.sun.webui.jsf.component.PanelGroupTag
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.

separatorfalsefalsejava.lang.String

The string of characters or HTML element that should be inserted between each component that is a child of this component. To specify an HTML element, use the character entities &lt; and &gt; to produce the < and > characters. You can use a block element such as <p> or <br> to force each component to be rendered on a separate line. If the separator attribute is not specified, the components are rendered with a single space between them.

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
blockfalsefalsejava.lang.String

By default, the panelGroup component is rendered on the same line as the component that comes before it and the component that follows, in a flow layout. If the block attribute is set to true, the panelGroup component is rendered on its own line. The components before it and after it are on different lines. The block attribute has no effect on the panelGroup component's children.


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.