com.google.gwt.user.cellview.client

Interface FooterBuilder<T>

Type Parameters:

T - the row data type

All Known Implementing Classes:

AbstractHeaderOrFooterBuilder, DefaultHeaderOrFooterBuilder

public interface FooterBuilder<T>

Builds the DOM elements for the footer section of a CellTable. It also provides queries on elements in the last DOM subtree that it created.

FooterBuilder provides two optional ways to handle events, via a Column, a Header, or both. If getColumn(Element) returns a Column given the target Element of an event, cell table will use it to enable features such as sorting. If getHeader(Element) returns a Header, cell table will forward the event to the Header. You can specify both a Column and Header.

The default implementation used by cell widgets is DefaultHeaderOrFooterBuilder.

Method Summary

Modifier and Type	Method and Description
TableSectionBuilder	buildFooter() Builds the DOM subtree for this footer.
Column<T,?>	getColumn(Element elem) Given an element in the DOM subtree returned by the most recent call to buildFooter(), returns the Column that should be the target of any button clicks or other events on that element, or null if the events should be discarded.
Header<?>	getHeader(Element elem) If you want to handle browser events using a subclass of Header, implement this method to return the appropriate instance and cell table will forward events originating in the element to the Header.
int	getRowIndex(TableRowElement row) Get the row index from the associated TableRowElement (an TR element).
boolean	isColumn(Element elem) Check if an element contains a Column.
boolean	isHeader(Element elem) Check if an element contains a Header.

Method Detail

buildFooter

TableSectionBuilder buildFooter()

Builds the DOM subtree for this footer. The root of the subtree must be a TFOOT element, as appropriate. This method may be called multiple times and should return a new DOM subtree each time.

If the footer is empty, return null.

Returns:

a TableSectionBuilder representing the new footer, or null if the footer is empty

getColumn

Column<T,?> getColumn(Element elem)

Given an element in the DOM subtree returned by the most recent call to buildFooter(), returns the Column that should be the target of any button clicks or other events on that element, or null if the events should be discarded. The column is used to support features such as column sorting.

Parameters:

elem - the element that the contains column

Returns:

the immediate column contained by the element

getHeader

Header<?> getHeader(Element elem)

If you want to handle browser events using a subclass of Header, implement this method to return the appropriate instance and cell table will forward events originating in the element to the Header. Return null if events from the element should be discarded.

Parameters:

elem - the element that the contains header

Returns:

the immediate Header contained by the element

getRowIndex

int getRowIndex(TableRowElement row)

Get the row index from the associated TableRowElement (an TR element).

Parameters:

row - the row element

Returns:

the row value index

isColumn

boolean isColumn(Element elem)

Check if an element contains a Column. This method should return false if and only if getColumn(Element) would return null.

Parameters:

elem - the element of interest

isHeader

boolean isHeader(Element elem)

Check if an element contains a Header. This method should return false if and only if getHeader(Element) would return null.

Parameters:

elem - the element of interest