wml::std::grid - Layout Grid
#use wml::std::grid
<grid [attributes]>
<cell [attributes]>...</cell>
:
<cell [attributes]>...</cell>
</grid>
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.
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
"1x"NCELL 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.
<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>
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
Internal: P1, P2, P3, P5
External: --