Using the TabbedPanel component

Top  Previous  Next

TabbedPanel component (FacesTabbedPanelImpl) implements FacesTabbedPanel interface. It has many properties responsible for tabbed panel appearance and behavior. It also has its data model and selection model. Data model consists of FacesTabbedPanelItem objects. Each FacesTabbedPanelItem object implements DataModel. FacesTabbedPanelItem instance has a set of properties defining behavior of tabbed panel item.

 

Also this component supports tab selection by AJAX operation.

 

You can set these properties on JSP page in <tabbedPanel:tabbedPanel> tag. It may contain only <tabbedPanel:tabbedPanelData> and <tabbedPanel:tabbedPanelSelection> tags.

 

If you use other framework than JSP you can use setter and getter methods on FacesTabbedPanel instance.

 

individual properties

 

Name

Description

id

Id of TabbedPanel component

name

Name of the component on the HTML page

 

look and feel properties for all TabbedPanel items

 

Name

Description

tabComponentStyle

HTML Style of the text used for tab drawing

tabComponentActiveStyle

HTML Style of the text used for tab drawing when tab is chosen

tabComponentHLightStyle

HTML Style of the text used for tab drawing when mouse points over it

tabComponentStyleClass

HTML Class of text used for tab drawing

tabComponentActiveStyleClass

HTML Class of text used for tab drawing when tab is chosen

tabComponentHLightStyleClass

HTML Class of text used for tab drawing when mouse points over it

wrap

Wrap the tab when there are no available space (true/false)

textWidth

Text width used to calculate tabs on row when wrap property used.

 

appearance properties

 

Name

Description

orientation

Defines layout of the component - horizontal or vertical. Must be: HORIZONTAL - horizontal layout;VERTICAL - vertical layout

Default : HORIZONTAL

 

images

 

Name

Description

imagesWidth

Width of the left and right images

imagesHeight

Height of the left and right images

leftActiveImage

URL of left active image

rightActiveImage

URL of right active image

centerActiveImage

URL of center active image

leftInactiveImage

URL of left inactive image

rightInactiveImage

URL of right inactive image

centerInactiveImage

URL of center inactive image

imageType

A tab can use one of the two types of images. Must be BIG or SMALL; Default : BIG

tabComponentImageWidth

Width of tab's image

tabComponentImageHeight

Height of tab's image

tabComponentSmallImageWidth

Width of tab's small image

tabComponentSmallImageHeight

Height of tab's image

 

behavior properties

 

Name

Description

tabSelectedListener

Uses with the serverSideAction property. Class must implement TabSelectedListener interface to handle client generated event. Handler method of this class will be called only if serverSideAction set to TRUE. Fully qualified Java class name of a TabSelectedListener to be created and registered.

serverSideAction

Server-side handling of client generated events. Must be TRUE|FALSE. If true - server-side handling of client generated events is enabled. Handler class must be set in the tabSelectedListener property.