tc
Tag tabGroup


Renders a tab group which contains tab panels.

UIComponentClass: org.apache.myfaces.tobago.component.UITabGroup

RendererType: TabGroup



Tag Information
Tag Classorg.apache.myfaces.tobago.internal.taglib.TabGroupTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
actionfalsefalsejavax.el.MethodExpression
(signature must match java.lang.Object action())
Action to invoke when clicked. This must be a MethodBinding or a String representing the application action to invoke when this component is activated by the user. The MethodBinding must evaluate to a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application. The string is directly passed to the navigation handler.
actionListenerfalsefalsejavax.el.MethodExpression
(signature must match void actionListener(javax.faces.event.ActionEvent))
MethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void.
bindingfalsefalsejavax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
The value binding expression linking this component to a property in a backing bean.

Warning: For the tobago extension library tx the binding differs from JSP and Facelets:

  • JSP: The component is the inner main control (e. g. UIInput).
  • Facelets: The component is the outer UIPanel.

Type: javax.faces.component.UIComponent
idfalsetruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
Type: java.lang.String
immediatefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
Flag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase.
Type: boolean
Default: false
markupfalsefalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.context.Markup)
Indicate markup of this component. The allowed markups can be defined or overridden in the theme. The value 'none' should not be used any longer. Just leave the attribute empty, or use a NULL pointer.
Type: org.apache.myfaces.tobago.context.Markup
renderedfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
Type: boolean
Default: true
renderedPartiallyfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String[])

Indicate the partially rendered components in a case of a submit.

The search depends on the number of prefixed colons in the relativeId:

number of prefixed colons == 0
fully relative
number of prefixed colons == 1
absolute (still normal findComponent syntax)
number of prefixed colons == 2
search in the current naming container (same as 0 colons)
number of prefixed colons == 3
search in the parent naming container of the current naming container
number of prefixed colons > 3
go to the next parent naming container for each additional colon

If a literal is specified: to use more than one identifier the identifiers must be space delimited.

Using this in a UISheet or UITabGroup component this list indicates components to update when calling internal AJAX requests like sort or paging commands. Don't forget to add the sheet-id or tagGroup-id in that case, if needed.

You can also use
Type: java.lang.String[]

selectedIndexfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Integer)
ValueBindingExpression pointing to a Integer to save the component's selected Tab.
Type: java.lang.Integer
Default: 0
showNavigationBarfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
Flag indicating that the tab navigation bar is rendered.
Type: boolean
Default: true
switchTypefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Indicating how tab switching should be done.

Possible values are:

client
Tab switching is done on client, no server Request.
reloadPage
Tab switching is done by server request. Full page is reloaded.
reloadTab
Tab switching is done by server request. Only the Tab is reloaded.

Type: java.lang.String
Default: client
Allowed Values: [client, reloadPage, reloadTab]
tabChangeListenerfalsefalsejavax.el.MethodExpression
(signature must match void tabChangeListener(org.apache.myfaces.tobago.event.TabChangeEvent))
No 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.