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.