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 tags for the columns). Header rows are also enclosed in 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 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 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 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