Using Table component

 Top  Previous  Next

Table component (FacesTableImpl) implements FacesTable interface. It has many properties responsible for table appearance and behavior. You can assemble table instance with the necessary behaviour using JSP tags or WebGalileo Faces API(see General Features item for detail).

 

Also this component supports Drag and Drop and AJAX operations.

 

The table component consists of the following mandatory modules:

 

•Interface manager - responsible for table's look and feel
•Headers - entities to hold various settings for table column headers
•Column model - model to manage table columns
•Data model - model to store and manage table's data
•Table component itself - main entity of the component to manage above models and entities.Besides,it contains top level properties responsible for general component behaviour.

 

 

•other properties

 

Name

Description

tableDataWriter

Fully qualified class name of the class implementing TableDataWriter interface responsible for data model persistence

customFileName

Fully qualified name of the property file without 'properties' extention. Used to localize table labels

ajaxRefreshEnabled

Allows table to use AJAX to update its content.

 

•look and feel properties

 

Name

Description

border

Defines whether to draw a table border. Default value : 1

borderColor

Border HTML color

cellPadding

Corresponds to HTML "cellpadding" property. Default value is 2

cellSpacing

Corresponds to HTML "cellSpacing" property. Default value is 2

rowHeight

Defines row height for all cells

horizontalBorderStyle

Defines row height for all cells

rowHeight

Defines row height for all cells

horizontalBorderStyle

This attribute is used to control the horizontal borders that will be displayed

verticalBorderStyle

This attribute is used to control the vertical borders that will be displayed

backGround

This attribute can be used to defines the image src that will be placed at the table background

 

•appearance properties

 

Name

Description

showHeader

This attribute can be used to set header visible or invisible

headerHintText

Defines header hint text

headerHeight

Defines header height

rowSelectionAllowed

This attribute can be used to enable/disable row selection. Default value - 'TRUE'.

rowSelectionType

Defines type of row selection mode. Default value - 'SINGLE'; Other available values: multiple, single_interval

columnSelectionAllowed

This attribute can be used to enable/disable column selection. Default value - FALSE.

columnSelectionType

Defines type of column selection mode. Default value - 'SINGLE'; Other available values: multiple, single_interval

editorMode

Defines editor mode for all edited cells. Default value - JUST, other available value INPLACE

autoColumnCreationMode

Defines whether a table will be created from the dataModel/columnModel. Default value - 'TRUE'

cellAltStep

Defines rows/columns step for background and foreground colors (see UI manager tag ). Default value is 1. Negative or zero value specifies the same color for all rows/columns

caption

Defines table caption

captionAlign

Table caption align mode

rules

This attribute together with a border attribute can be used to control the borders that will be displayed.

Permissible values:

none -removes all the internal rules;

basic - displays horizontal borders between the table header,

body and footer;

rows - displays horizontal borders between all rows;

cols - displays vertical borders between all columns;

all - displays all the internal rules.

frame

This attribute together with a border attribute can be used to control the borders that will be displayed.

Values:

void - removes all the external borders; above - displays external borders at the top of the table only;

below - displays external borders at the bottom of the table only;

hsides- displays external borders at the horizontal sides of the table;

lhs- displays external borders at the left edges of the table;

rhs- displays external borders at the right edges of the table;

vsides- displays external borders at both left and right edges of the table;

box- displays a box around the table.

visibleRowCount

To show only desired quantity of rows

 

•behavior properties

 

Name

Description

tableSortSelectedListener

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

tableCellSelectedListener

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

tableCellDblClickedListener

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

tableNavigationSelectedListener

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

tableRowsPerPageChangedListener

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

serverSideAction

Handler class must be set in the tableSortSelectedListener, tableNavigationSelectedListener, tableRowsPerPageChangedListener, tableCellSelectedListener or tableCellDblClickedListener properties. Must be true|false. If true - server-side handling of client generated events enabled.

 

•Progress Bar properties

 

Name

Description

ajaxProgressShow

True - show Progress Bar when ajax request processing. Default TRUE

ajaxProgressTitle

The text label of the Progress Bar

ajaxProgressId

Progress Bar ID. Binds stabdaloane Progress Bar to Component via Progressbar ID