row
Formats text into a non-HTML table.
Summary
| Parameter
|
Description
|
Default
|
| width |
Maximum width of each line. |
None |
Examples
Perl example
$Tag->row({
width => $width,
body => $body,
});
|
or similarly with positional parameters:
|
$Tag->row($width, $attribute_hash_reference, $body);
|
Description
This tag helps to format text into a non-HTML table.
This is intended for use in emailed reports and
"<pre></pre>" regions in HTML.
The width parameter specifies the number of columns to use.
Inside the row tag,
a number of [column] sub-tags may be used.
A common usage might be as follows:
(from the Standard demo's "etc/mail_reciept" file)
...
Quan Item No. Description Price Extension
---- ----------- ------------------------------- -------------- ----------------
[item-list][row 82]
[column width=5 gutter=1 align=right] [item-quantity] [/column]
[column width=12 gutter=1] [item-code] [/column]
[column width=32 gutter=1 align=left wrap=1]
[item-description]
[if-modifier size]SIZE-->[item-modifier size][/if-modifier][if-modifier color] COLOR-->[item-modifier color][/if-modifier]
[/column]
[column width=15 gutter=1 align=r] [item-price] [/column]
[column width=17 gutter=1 align=r] [item-subtotal] [/column]
[/row]
...
[/item-list]
|
Parameters
width
The maximum width of each line, including all columns and their gutters.