NAME

CGI::Widget::DBI::Search::Display::Table - HTML table display class for Search widget

SYNOPSIS

my $ws = CGI::Widget::DBI::Search->new(q => CGI->new);
...
$ws->{-display_class} = 'CGI::Widget::DBI::Search::Display::Table';

# or instead, simply:
$ws->{-display_mode} = 'table';

# note: this is default behavior for the search widget, so this is all just for
# informational purposes, e.g. to write your own display class

DESCRIPTION

This class displays search results retrieved in the search widget in table format, much like the output from a typical relational database client. The dataset can be sorted via column header anchor tags, and paging links appear on all corners of the table display, as well as a list of navigable page ranges at bottom center.

METHODS

render_dataset()

Builds HTML table rows for current page in the dataset, including a header row with the visible columns with sortable columns as clickable anchor tags.

Builds data in object variables:

dataset_rows_html
header_columns
header_html
render_column_headers()

Called by render_dataset() to render just the column headers (along with sort links) for the most recent search.

display_dataset()

Returns HTML rendering of current page in search results, along with navigation links.

display_row( $row )

Returns HTML rendering of given $row in dataset: '<tr> ... </tr>'. Calls display_field($row, $header_col) for each header column.

display_field( $row, $col )

Returns HTML rendering of given $row / $col in dataset: '<td> ... </td>'. Calls display_record($row, $col), inherited from CGI::Widget::DBI::Search::AbstractDisplay for the cell contents.

SEE ALSO

CGI::Widget::DBI::Search::AbstractDisplay