Skip to content

Table

Available Table style options:

  • alignment. Supports all alignment modes since 1st Edition of ECMA-376 standard up till ISO/IEC 29500:2012. See \PhpOffice\PhpWord\SimpleType\JcTable and \PhpOffice\PhpWord\SimpleType\Jc class constants for possible values.
  • bgColor. Background color, e.g. '9966CC'.
  • border(Top|Right|Bottom|Left)Color. Border color, e.g. '9966CC'.
  • border(Top|Right|Bottom|Left)Size. Border size in twip.
  • cellMargin(Top|Right|Bottom|Left). Cell margin in twip.
  • indent. Table indent from leading margin. Must be an instance of \PhpOffice\PhpWord\ComplexType\TblWidth.
  • width. Table width in Fiftieths of a Percent or Twentieths of a Point.
  • unit. The unit to use for the width. One of \PhpOffice\PhpWord\SimpleType\TblWidth. Defaults to auto.
  • layout. Table layout, either fixed or autofit See \PhpOffice\PhpWord\Style\Table for constants.
  • cellSpacing Cell spacing in twip
  • position Floating Table Positioning, see below for options
  • bidiVisual Present table as Right-To-Left

Floating Table Positioning options:

  • leftFromText Distance From Left of Table to Text in twip
  • rightFromText Distance From Right of Table to Text in twip
  • topFromText Distance From Top of Table to Text in twip
  • bottomFromText Distance From Top of Table to Text in twip
  • vertAnchor Table Vertical Anchor, one of \PhpOffice\PhpWord\Style\TablePosition::VANCHOR_*
  • horzAnchor Table Horizontal Anchor, one of \PhpOffice\PhpWord\Style\TablePosition::HANCHOR_*
  • tblpXSpec Relative Horizontal Alignment From Anchor, one of \PhpOffice\PhpWord\Style\TablePosition::XALIGN_*
  • tblpX Absolute Horizontal Distance From Anchorin twip
  • tblpYSpec Relative Vertical Alignment From Anchor, one of \PhpOffice\PhpWord\Style\TablePosition::YALIGN_*
  • tblpY Absolute Vertical Distance From Anchorin twip

Available Row style options:

  • cantSplit. Table row cannot break across pages, true or false.
  • exactHeight. Row height is exact or at least.
  • tblHeader. Repeat table row on every new page, true or false.

The ODText writer serializes row heights as native ODF table-row styles. An exact height uses style:row-height; an at-least height uses style:min-row-height.

Available Cell style options:

  • bgColor. Background color, e.g. '9966CC'.
  • border(Top|Right|Bottom|Left)Color. Border color, e.g. '9966CC'.
  • border(Top|Right|Bottom|Left)Size. Border size in twip.
  • border(Top|Right|Bottom|Left)Style. Border style. You can use constants from \PhpOffice\PhpWord\SimpleType\Border
  • gridSpan. Number of columns spanned.
  • textDirection(btLr|tbRl). Direction of text. You can use constants \PhpOffice\PhpWord\Style\Cell::TEXT_DIR_BTLR and \PhpOffice\PhpWord\Style\Cell::TEXT_DIR_TBRL
  • valign. Vertical alignment, top, center, both, bottom.
  • vMerge. restart or continue.
  • width. Cell width in twip.

The ODText writer serializes cell borders as native ODF table-cell styles. Each configured side is written independently, so asymmetric cell borders and different border definitions on cells in the same row are preserved.

The ODText writer also serializes table and cell bgColor values as native ODF background colors. Cell padding, vertical alignment, text direction, wrapping, column spans, table alignment, and table width are mapped when the corresponding PHPWord style options are present.