---
name: "wml::std::grid"
section: "3"
platform: "linux"
package: "wml"
version: "2.32.0~ds1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/wml::std::grid"
---

# wml::std::grid(3)

Layout Grid

## 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.