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 "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.
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: --
SEE ALSO
HTML <"table">-tag.