NAME

wml::std::grid - Layout Grid
SYNOPSIS

 <grid [attributes]>
   <cell [attributes]>...</cell>
     :
   <cell [attributes]>...</cell>
 </grid>



DESCRIPTION
The <grid> container tag provides a mixture between a HTML table
and a TeX-like way of specifying its dimensions and the alignment of its
cells.



ATTRIBUTES
First the possible attributes for <grid>:

summary



This attribute will be inserted into the table tag, see documentation
of HTML 4.0 for details on why this attribute is recommended.


layout



This specifies the layout of the grid in X and Y dimension, i.e. 3x2 means
3 columns (x-dimension) and 2 rows (y-dimension). Default is 1xNCELL
where NCELL is the number of cell tags or in other words: Default is a
top-down list.


align



This specifies the horizontal alignment of the cells in a row. The argument
has to contain as many characters as there are cells in a row. The supported
alignment characters are `l' (left), `r' (right) and `c' (center).
Default is `l...l' (as much l's as there are cells in a row).


valign



This specifies the vertical alignment of the cells in a column. The argument
has to contain as many characters as there are cells in a column. The
supported alignment characters are `t' (top), `b' (bottom) and `m'
(middle). Default is `t...t' (as much t's as there are cells in a
column).


width



This is the corresponding attribute of the HTML <table> tag. Use it
to set the width of the grid. Default is no specified width.


spacing



This is the corresponding attribute to cellspacing of the HTML
<table> tag. Use it to set the spacing of cells in the grid, i.e.
the space around the content of each cell. Default is 0 (no space).


padding



This is the corresponding attribute to <cellpadding> of the HTML
<table> tag. Use it to set the padding between cells in the grid,
i.e. the inter-cell space. Default is 0 (no space).


border



This is the corresponding attribute of the HTML <table> tag. Use it
to set the border width of the grid. Default is 0 (no border).


bgcolor



This is the corresponding attribute of the HTML <table> tag. Use it
to set the background color of the grid. Default is no specified color.


color



This sets the foreground (text) color of the grid's contents. Actually this
sets the default for the same attribute of <cell>. Default is no
specified color.


Second the possible attributes for <cell>:

align



This is the corresponding attribute of the HTML <td> tag. Use it to
set the horizontal alignment of the cell's contents. Default is taken from the
same attribute of <grid>.


valign



This is the corresponding attribute of the HTML <td> tag. Use it to
set the vertical alignment of the cell's contents. Default is taken from the
same attribute of <grid>.


bgcolor



This is the corresponding attribute of the HTML <td> tag. Use it to
set the background color of a particular cell. Default is no specified color.


color



This sets the foreground (text) color of the cell's contents. This is done
via the HTML <font> tag. Default is no specified color or the
color from the same attribute of <grid>.


rowspan



This is the corresponding attribute of the HTML <td> tag. Use it to
span a cell over more then one row of the grid. Default is 1 row.


colspan



This is the corresponding attribute of the HTML <td> tag. Use it to
span a cell over more then one column of the grid. Default is 1 column.


width



This is the corresponding attribute of the HTML <td> tag. Use it to
set the width of the cell. Default is no specified width.


height



This is the corresponding attribute of the HTML <td> tag. Use it to
set the height of the cell. Default is no specified height.





EXAMPLE
  <grid bgcolor="#000000" color="#ffffff"
        layout="3x2" align="llr" valign="tm">
    <cell>A</cell> <cell>B</cell> <cell>C</cell>
    <cell>D</cell> <cell>E</cell> <cell>F</cell>
  </grid>



AUTHOR
 Ralf S. Engelschall
 rse@engelschall.com
 www.engelschall.com



REQUIRES
 Internal: P1, P2, P3, P5
 External: --



SEEALSO
HTML <table>-tag.