webuijsf
Tag tab


Use the webuijsf:tab within the webuijsf:tabSet tag to create a tab within a set of tabs in the rendered HTML page. The webuijsf:tab tag extends the webuijsf:hyperlink tag. The webuijsf:tab tag differs from webuijsf:hyperlink tag in the value rendered by default for the class attribute of the rendered HTML anchor.

HTML Elements and Layout

The tab component renders an XHTML <a href> tag.

Configuring the webuijsf:tab Tag

The webuijsf:tab tag can be configured with many of the same attributes as the webuijsf:hyperlink tag. The tab can be configured to display its associated JSP page using the url or action attributes. The tab can be configured to perform an action such as updating data displayed in the page using the actionListener attribute.

If you add child Tab components to a Tab component, making a multiple level set of tabs, you can use the selectedChildId to specify the initially selected child tab.

Facets

None.

Client Side Javascript Functions

None.

Examples

See the webuijsf:tabSet documentation for an example of defining tabs by using a TabSet component binding.

Example 1: Defining three tabs in a tab set

<webuijsf:tabSet id="MyTabs" selected="tab1" >
     <webuijsf:tab id="tab1" text="Tab 1" action="#{TabSetBean.tab1Clicked}" />
     <webuijsf:tab id="tab2" text="Tab 2" action="#{TabSetBean.tab2Clicked}" />
     <webuijsf:tab id="tab3" text="Tab 3" action="#{TabSetBean.tab3Clicked}" />
</webuijsf:tabSet >



Tag Information
Tag Classcom.sun.webui.jsf.component.TabTag
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 binding allows the Java bean that contains the UIComponent to manipulate the UIComponent, its properties, and its children.
textfalsefalsejava.lang.String

The text to be displayed for the hyperlink.

onDblClickfalsefalsejava.lang.String Scripting code executed when a mouse double click occurs over this component.
selectedChildIdfalsefalsejava.lang.String The id of this tab's currently selected Tab child or null if one is not selected.
onKeyPressfalsefalsejava.lang.String

Scripting code executed when the user presses and releases a key while the component has focus.

targetfalsefalsejava.lang.String

The resource at the specified URL is displayed in the frame that is specified with the target attribute. Values such as "_blank" that are valid for the target attribute of a HTML anchor element are also valid for this attribute in this component

onFocusfalsefalsejava.lang.String

Scripting code executed when this component receives focus. An element receives focus when the user selects the element by pressing the tab key or clicking the mouse.

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

The language code of the resource designated by this hyperlink.

idfalsetruejava.lang.StringNo Description
onKeyUpfalsefalsejava.lang.String

Scripting code executed when the user releases a key while the component has focus.

onMouseUpfalsefalsejava.lang.String

Scripting code executed when the user releases a mouse button while the mouse pointer is on the component.

styleClassfalsefalsejava.lang.String

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

actionListenerExpressionfalsefalsejava.lang.String Use the actionListenerExpression attribute to cause the component to fire an event. The value must be an EL expression and it must evaluate to the name of a public method that takes an ActionEvent parameter and returns void.
stylefalsefalsejava.lang.String

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

urlfalsefalsejava.lang.String

Absolute, relative, or context relative (starting with "/") URL to the resource selected by this hyperlink. If the url attribute is specified, clicking this hyperlink sends the browser to the new location. If the action attribute is specified, the form is submitted. If both are specified, the url attribute takes precedence.

onClickfalsefalsejava.lang.String

Scripting code executed when a mouse click occurs over this component. If the component submits the form (by using the action attribute), the script that you use with the onClick attribute should not return from the function. When the action attribute is used, the component handles the return with a script that is appended to the anchor element's onclick property. When you supply an onClick attribute, this return script is appended after your script in the anchor's onclick. It is ok to return from your script to abort the submit process if necessary.

onBlurfalsefalsejava.lang.String

Scripting code executed when this element loses focus.

onMouseDownfalsefalsejava.lang.String

Scripting code executed when the user presses a mouse button while the mouse pointer is on the component.

toolTipfalsefalsejava.lang.String

Sets the value of the title attribute for the HTML element. The specified text will display as a tooltip if the mouse cursor hovers over the HTML element.

typefalsefalsejava.lang.String

The MIME content type of the resource specified by this component.

actionExpressionfalsefalsejava.lang.String MethodExpression representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application.
disabledfalsefalsejava.lang.String

Flag indicating that clicking of this component by the user is not currently permitted.

onMouseOutfalsefalsejava.lang.String

Scripting code executed when a mouse out movement occurs over this component.

onMouseOverfalsefalsejava.lang.String

Scripting code executed when the user moves the mouse pointer into the boundary of this component.

onMouseMovefalsefalsejava.lang.String

Scripting code executed when the user moves the mouse pointer while over the component.

htmlTemplatefalsefalsejava.lang.String Alternative HTML template to be used by this component.
immediatefalsefalsejava.lang.String Flag indicating that event handling for this component should be handled immediately (in Apply Request Values phase) rather than waiting until Invoke Application phase.
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.

onKeyDownfalsefalsejava.lang.String

Scripting code executed when the user presses down on a key while the component has focus.

tabIndexfalsefalsejava.lang.String

Position of this element in the tabbing order of the current document. Tabbing order determines the sequence in which elements receive focus when the tab key is pressed. The value must be an integer between 0 and 32767.


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.