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.

EN Tools                                           2020-11-29                                  wml::std::grid(3)