Tables

The <Table> element renders tabular data with titles, rows, and cells. Tables support horizontal and vertical orientations, per-cell/row backgrounds, and JSON model binding for data-driven content.

Note

Inside tables, <Title> is not valid. Use <HTitle> for horizontal table headers and <VTitle> for vertical table titles.

Note

Column weighting exists on the underlying DocraftLoomTable node (set_column_weights()), but is not yet exposed as a Craft Language XML attribute — there is currently no way to set it from a .craft file.

Note

A <Cell>’s content must be a <Text> (or <Title>/<Subtitle>/ <PageNumber>) or an <Image> — anything else is a parse error. position="absolute" on a cell or its content is also rejected (InvalidInputException at layout time); table cells only support normal flow positioning.

Basic Table (Horizontal)

<Table>
  <THead>
    <HTitle font_size="11" style="bold">Name</HTitle>
    <HTitle font_size="11" style="bold">Price</HTitle>
  </THead>
  <TBody>
    <Row>
      <Cell><Text>Widget A</Text></Cell>
      <Cell><Text>$9.99</Text></Cell>
    </Row>
    <Row>
      <Cell><Text>Widget B</Text></Cell>
      <Cell><Text>$14.50</Text></Cell>
    </Row>
  </TBody>
</Table>

Basic Table (Vertical)

Vertical orientation is not a separate attribute — it’s selected by setting model="vertical" on <Table> itself (the model attribute is overloaded: "vertical"/"horizontal" pick an orientation directly, any other value is treated as a JSON/template data model, see “Data-Driven Tables” below). <THead> is mandatory for horizontal tables without a JSON model; a vertical table has no <THead> at all — every row supplies its own <VTitle> instead.

<Table model="vertical">
  <TBody>
    <Row>
      <VTitle font_size="11" style="bold">Name</VTitle>
      <Cell><Text>Widget A</Text></Cell>
    </Row>
    <Row>
      <VTitle font_size="11" style="bold">Price</VTitle>
      <Cell><Text>$9.99</Text></Cell>
    </Row>
  </TBody>
</Table>

Note

<VTitle> is mandatory on every row of a vertical table — a row missing it is a parse error. JSON/template model data binding is not supported with vertical orientation; build vertical tables by hand.

Attributes

Attribute	Type	Description
`model`	string	Overloaded: literal `"vertical"`/`"horizontal"` picks the table’s orientation explicitly; any other value is a `${variable}` reference to JSON data (matrix or object array, horizontal only).
`baseline_offset`	float	Vertical offset for text alignment within cells (default `0.25`).

Header Title Attributes

Each <HTitle> in horizontal tables and each <VTitle> in vertical tables supports:

Attribute	Type	Description
`alignment`	string	`left` \| `center` \| `right` \| `justified`.
`style`	string	`normal` \| `bold` \| `italic` \| `bold_italic`.
`color`	color	Title text color.
`background_color`	color	Title cell background.

Row Attributes

Attribute	Type	Description
`background_color`	color	Row background color.

Data-Driven Tables

Tables can bind to JSON data via a template variable:

<Table model="${products}">
  <THead>
    <HTitle style="bold">Name</HTitle>
    <HTitle style="bold">Price</HTitle>
  </THead>
</Table>

The model attribute accepts:

String matrix: [["A","$10"],["B","$20"]]
Object array: [{"name":"A","price":"$10"}] — column order matches header order.

The header can also be bound with a template variable using model on <THead>.