NAME

 HTML::Widgets::Table - An HTML table generation class.

SYNOPSIS

 use HTML::Widgets::Table;
 my $table = HTML::Widgets::Table->new(\%params);
 my $html = $table->render;

DESCRIPTION

 HTML::Widgets::Table creates an HTML table from native data structures.

METHODS

new(\%params)

 Create a new table object.  Parameters that can be passed
 include any legal attributes for an HTML table tag.  In
 addition, the following parameters may be passed.

 pretty_border => 1
 pretty_border_color => '#669999'

    If pretty_border is a true value, the table will be rendered
    with a browser-independent border by putting the table inside
    another table, allowing the background color of the outside
    table come through as the border.  The value of pretty_border
    will be with width of the border, and pretty_border_color
    will be the color of the border.

 alternating_row_colors => [ '#ffffff',
                             '#f2f2f2'
                           ]

    You can use this to alternate the background color of the
    rows in the table.  This is useful for making tables without
    borders and rules easier to read.

addHeaderRow(\@data, \%cell_params, \%params)

 Adds a header row to the table (as in the <th> tags for the
 columns).  Header rows are also enclosed in <thead> tags.  @data
 is an array of column values.  Any elements of the array that
 are hash references are taken to be key/value pairs with the
 cell contents as the value associated with the key 'data', and
 all the other key/value pairs are attributes to be applied to
 that cell.  These override the values in %cell_params.
 %cell_params are default attributes for every column in the row.
 %params are the row attributes to go in the <tr> tag.

addRow(\@data, \%cell_params, \%params)

 Adds a new row to the table.  @data is an array of column
 values.  Any elements of the array that are hash references are
 taken to be key/value pairs with the cell contents as the value
 associated with the key 'data', and all the other key/value
 pairs are attributes to be applied to that cell.  These override
 the values in %cell_params.  %cell_params are default attributes
 for every column in the row.  %params are the row attributes to
 go in the <tr> tag.

setRepeatingHeaderRow(\@data, \%cell_params, \%params, $repeat_interval)

 Adds a header row to be repeated every $repeat_interval rows.
 This is useful to keep the user oriented when viewing long tables.

setRepeatingRow(\@data, \%cell_params, \%params, $repeat_interval)

 Adds a row to be repeated every $repeat_interval rows.
 This is useful to keep the user oriented when viewing long tables.

render()

 Returns a string containing the HTML version of the table.

AUTHOR

 Don Owens <don@owensnet.com>

COPYRIGHT

 Copyright (c) 2003 Don Owens

 All rights reserved. This program is free software; you can
 redistribute it and/or modify it under the same terms as Perl
 itself.

VERSION

 0.01