WML::STD::GRID(1)

NAME
wml::std::grid - Layout Grid

SYNOPSIS

 #use wml::std::grid
 <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.