Version 5.8.0

# `Table`

Create a table that is similar to the HTML table model.

## Child elements

`Columns`, `Copy-of`, `ForAll`, `Loop`, `Message`, `SetVariable`, `Switch`, `TableNewPage`, `Tablefoot`, `Tablehead`, `Tablerule`, `Tr`, `Value`

## Parent elements

`Case`, `Clip`, `ForAll`, `Frame`, `Loop`, `Otherwise`, `Overlay`, `PlaceObject`, `Position`, `SetVariable`, `Td`, `Transformation`, `Until`, `While`

## Attributes

`balance` (optional, since version 3.1.24)
  Tries to balance the table on the last page according to the number of frames. Experimental!
  - `yes`: Tries to balance.
  - `no`: First column will filled first, default
`border-collapse` (optional)
  Determine if adjacent table cells share borders. The behavior of border-collapse=“collapse” is undefined when the table has columndistance or rowdistance set to a non-zero value and if the adjacent borders don’t have the same width and color.
  - `separate`: The borders are part of the cell and not shared with its neighbors.
  - `collapse`: The borders of neighboring cells overlap.
`break-pagetype` (text, optional, since version 5.7.5)
  When the table is split at a page break, an extra page of the given page type is inserted between the two parts of the table. The contents of that page must be created with `AtPageCreation` of the page type. The page numbering continues as usual. An empty value disables the insertion.
`columndistance` (length, optional)
  Distance between two table columns.
`eval` (XPath expression, optional)
  Evaluates the given XPath expression and discards its output.
`eval-on-split` (XPath expression, optional, since version 5.5.10)
  XPath expression that is evaluated at each table split (page break). This expression is evaluated before the background colors of the body rows are re-evaluated. Can be used e.g. with `sd:reset-alternating()` to restart alternating row colors on each page.
`fontfamily` (text, optional)
  Name of the font family for the table. If not given, the font face ‘text’ is used.
`leading` (length, optional)
  The distance between two rows.
`padding` (length, optional)
  The distance between the table border and the table contents.
`parent` (text, optional, since version 4.19.23)
  The id of the parent structure element for tagged PDF
`role` (optional, since version 4.19.23)
  The role for PDF/UA (accessibility, tagged PDF)
`stretch` (optional)
  If the table contents is narrow and stretch has the value no, the table only uses the minimal width. If the table contents is wider than the value width or stretch has the value max, the table’s width is the size given in the width attribute.
  - `max`: Stretch the table to its given width.
  - `no`: The table width is the minimum width depending on it’s contents.
`textformat` (text, optional, since version 3.7.23)
  The text format for the table. Defaults to `__leftaligned` if no align attribute is given.
`vexcess` (optional, since version 4.5.12)
  Set behaviour when cells stretch in vertical direction due to rowspans.
  - `stretch`: Stretch all table cells evenly (default).
  - `bottom`: Only stretch the last table cell.
`width` (number or length, optional)
  The maximum width of the table (in grid cells or absolute values). Defaults to the available space.

## Remarks

The table cells may contain Paragraphs, Images and other objects that are allowed in `PlaceObject`.

## Example

    <Record element="data">
      <PlaceObject>
        <Table stretch="max" padding="1pt">
          <Tablehead>
            <Tr background-color="gray">
              <Td colspan="3"/>
              <Td border-left="0.2pt" border-left-color="white" colspan="6" align="center">
                <Paragraph><B><Value>Total</Value></B></Paragraph></Td>
              <Td border-left="0.2pt" border-left-color="white"/>
            </Tr>
            <Tr background-color="gray">
              <Td/>
              <Td><Paragraph><B><Value>Clubs</Value></B></Paragraph></Td>
              <Td><Paragraph><B><Value>P</Value></B></Paragraph></Td>
              <Td align="center" border-left="0.2pt" border-left-color="white">
                <Paragraph><B><Value>W</Value></B></Paragraph>
              </Td>
              <Td align="center"><Paragraph><B><Value>D</Value></B></Paragraph></Td>
              <Td align="center"><Paragraph><B><Value>L</Value></B></Paragraph></Td>
              <Td align="center"><Paragraph><B><Value>F</Value></B></Paragraph></Td>
              <Td align="center"><Paragraph><B><Value>A</Value></B></Paragraph></Td>
              <Td align="center"><Paragraph><B><Value>+/-</Value></B></Paragraph></Td>
              <Td align="center" border-left="0.2pt" border-left-color="white">
                <Paragraph><B><Value>Pts</Value></B></Paragraph>
              </Td>
            </Tr>
          </Tablehead>
          <ForAll select="entry">
            <Tr>
              <Td align="left"><Paragraph><Value select="@pos"/></Paragraph></Td>
              <Td align="left"><Paragraph><Value select="@name"/></Paragraph></Td>
              <Td align="center"><Paragraph><Value select="@p"/></Paragraph></Td>
              <Td align="center" border-left="0.2pt" border-left-color="gray">
                <Paragraph><Value select="@tw"/></Paragraph>
              </Td>
              <Td align="center"><Paragraph><Value select="@td"/></Paragraph></Td>
              <Td align="center"><Paragraph><Value select="@tl"/></Paragraph></Td>
              <Td align="center"><Paragraph><Value select="@ta"/></Paragraph></Td>
              <Td align="center"><Paragraph><Value select="@tf"/></Paragraph></Td>
              <Td align="center"><Paragraph><Value select="@tpm"/></Paragraph></Td>
              <Td align="center" border-left="0.2pt" border-left-color="gray">
                <Paragraph><Value select="@pts"/></Paragraph>
              </Td>
            </Tr>
          </ForAll>
        </Table>
      </PlaceObject>
    </Record>

Using the following data:

    <data>
      <entry pos="1" name="Paris Saint-Germain FC" p="6"
          tw="5" td="0" tl="1" tf="14" ta="3" tpm="11" pts="15" />
      <entry pos="2" name="FC Porto" p="6"
          tw="4" td="1" tl="1" tf="10" ta="4" tpm="6" pts="13" />
      <entry pos="3" name="FC Dynamo Kyiv" p="6"
          tw="1" td="2" tl="3" tf="6"  ta="10" tpm="-4" pts="5" />
      <entry pos="4" name="GNK Dinamo Zagreb" p="6"
          tw="0" td="1" tl="5" tf="1"  ta="14" tpm="-13" pts="1" />
    </data>

#### On this page