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.