Tables

Implement the WithTables interface to replace table placeholders in your Word template with data tables.

Interface

interface WithTables
{
    public function tables(): array;
}

Return an array mapping placeholder names to table data or closures that return table data. Keys are the placeholder names in the template.

Table data structure

Each value must be an array (or a closure returning one) with:

• headers: Array of header cells. Each cell can be a string or ['width' => int, 'text' => string]. For PDF export, set column widths on headers so columns render correctly.
• rows: Array of rows; each row is an array of cell values (strings or ['width' => int, 'text' => string]).
• style (optional): Array with borderSize, borderColor, width, etc.
• defaultFontStyle (optional): Default font style for all cells. If omitted, the package tries to inherit the font style from the ${placeholder} in the Word template.
• defaultParagraphStyle (optional): Default paragraph style for all cells.
• Per-cell overrides: use fontStyle or paragraphStyle on header/cell arrays; these take precedence over defaultFontStyle.

Font style inheritance

When the table placeholder in your Word template has a custom font (name, size, bold, italic, color), table cells inherit that style automatically unless you set defaultFontStyle explicitly in the table data.

Scenario	Result
Token has font style, no cell override	Cells inherit token style
Token has font style, cell has fontStyle	Cell style wins
defaultFontStyle set in table data	Explicit value is kept, no lookup
Token has no detectable style	No extra style applied

Example

use Santwer\Exporter\Concerns\FromWordTemplate;
use Santwer\Exporter\Concerns\WithTables;

class InvoiceExport implements FromWordTemplate, WithTables
{
    public function wordTemplateFile(): string
    {
        return 'templates/invoice.docx';
    }

    public function tables(): array
    {
        return [
            'invoiceItems' => function () {
                return [
                    'headers' => [
                        ['width' => 3000, 'text' => 'Item'],
                        ['width' => 2000, 'text' => 'Quantity'],
                        ['width' => 2000, 'text' => 'Price'],
                    ],
                    'rows' => [
                        ['Product A', '2', '100.00'],
                        ['Product B', '1', '50.00'],
                    ],
                    'style' => [
                        'borderSize' => 6,
                        'borderColor' => '000000',
                        'width'      => 7000,
                    ],
                ];
            },
        ];
    }
}

PDF export

For PDF output, at least the headers should have column widths set. Unset column widths may not display correctly in the generated PDF.