NAME HTML::Tag::Macro::Table

SYNOPSIS

use HTML::Tag::Macro::Table;
my $table = HTML::Tag::Macro::Table.new;
my @data = 'Val 1', 'Val 2', 'Total';
$table.row(:header, @data);
@data = 111, 22, 133;
$table.row(@data);
$table.render;
# <table><tr><th>Val 1</th><th>Val 2</th><th>Total</th></tr><tr><td>111</td><td>22</td><td>133</td></tr></table>
# ... or replace @data above and use rows() for multiple rows with 2-d array
@data = ((111, 22, 133),
(222, 33, 255));
$table.rows(@data);
$table.render;
# <table><tr><th>Val 1</th><th>Val 2</th><th>Total</th></tr><tr><td>111</td><td>22</td><td>133</td></tr><tr><td>222</td><td>33</td><td>255</td></tr></table>   

DESCRIPTION

Creates a combination of ::th ::td ::tr tags swallowed by a ::table tag to help automate the creation of an HTML table.

HTML::Tag::Macro::Table has 2 methods: row() and rows().

row(@array_of_table_row_data) - each element of the array will be surrounded by ::td tags in the row.

row(:header) designates the row as an HTML header row (so ::th tags will be u sed instead of ::td tags for that row).

row(:td-opts) applies ::td tag options to select ::td elements generated in the row. That element is selected by specifying the numeric key and the value becomes the options to apply. For example, to apply options to the second td element,

$td-opts = %( 2 => {class => 'pretty'});

row(:tr-opts) applies ::tr tag options to the row.

If you want to generate the table by specifying multiple rows, you can do so with a 2-d array, where each element is a list of table data, using the rows() method instead of row().

@data = ((34, 53, 23),
         (43, 23, 55),
         (27, 32, 66));
$table.rows(@data);

The rows() method also takes the :td-opts and :tr-opts options, but they are passed to every single row.

Table options can be specified when instantiating the table macro with new using the (:table-opts) hash.

AUTHOR

Mark Rushing [email protected]

LICENSE

This is free software; you can redistribute it and/or modify it under the Artistic License 2.0.