Using the Toolbar component

Top  Previous  Next

Toolbar component (FacesToolbarImpl) implements FacesToolbar interface. It has many properties responsible for toolbar appearance and behavior. It also has its data model and selection model. Data model consists of FacesPageToolbar objects. Which in turn will consist from FacesPageHeadToolbar and FacesToolbarItem objects.

 

You can set these properties on JSP page into <toolbar:toolbar> tag. It may contain only <toolbar:toolbarData> and <toolbar:toolbarSelection> tags.

 

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

 

individual properties

 

Name

Description

id

Id of Toolbar component

name

Label of the component on the HTML page

hintText

Toolbar's tooltip text

 

look and feel properties

 

Name

Description

fontFamily

Any valid HTML font family

fontWeight

Any valid HTML font weight

fontStyle

Any valid HTML font style

fontColor

Any valid HTML font color of a header

selectedFontColor

Any valid HTML color

fontSize

Any valid HTML font size

itemFontColor

Any valid HTML font color of an item

bgColor

Any valid HTML color of toolbar's page

pageHeaderBgColor

Any valid HTML color of toolbar's page header

 

appearance properties

 

Name

Description

frameMode

Defines whether toolbar should be rendered to a HTML frame. TRUE,FALSE; Default value : FALSE

headerAlign

Header alignment. LEFT,CENTER; Default value : LEFT

verticalSize

Whole toolbar vertical height in percents. Any numeric value without the "%" sign

styleClass

HTML Class of text used for toolbar page drawing

style

HTML Style of the text used for toolbar page drawing

 

images

 

Name

Description

iconMode

Display mode of the items. SMALL,LARGE; Default value : LARGE

iconWidth

Width in pixels for default Icons

iconHeight

Height in pixels for default Icons

smallIconWidth

Width in pixels for small Icons

smallIconHeight

Height in pixels for small Icons

 

behavior properties

 

Name

Description

toolbarItemSelectedListener

Full class handler name. Uses with the serverSideAction property. Class must implement ToolbarItemSelectedListener interface to handle client generated event. Handler method of this class will be called only if serverSideAction set to true. Fully qualified listener class name

toolbarHeaderSelectedListener

Uses with the serverSideAction property. Class must implement ToolbarHeaderSelectedListener interface to handle client generated event.Handler method of this class will be called only if serverSideAction set to true. Fully qualified listener class name

userOnHeaderSelect

User defined callback function called when any page is selected in the form of "anyFunctionName(aHeaderIndex)". If the function returns "false" the given page won't be opened.

userOnItemSelect

User defined callback function called when any item is selected in the form of "anyFunctionName(aHeaderIndex,anItemIndex)"