docx-js/docs/usage/tables.md

Tables

You can create tables with docx. More information can be found here.

How to

To create a table, simply use the createTable method on a document.

const table = doc.createTable([NUMBER OF ROWS], [NUMBER OF COLUMNS]);

Alternatively, you can create a table object directly, and then add it in the document

const table = new Table(4, 4);
doc.addTable(table);

The snippet below creates a table of 2 rows and 4 columns.

const table = doc.createTable(2, 4);

// Or

const table = new Table(2, 4);
doc.addTable(table);

Cells

The above section created a table with cells. To access the cell, use the getCell method.

const cell = table.getCell([ROW INDEX], [COLUMN INDEX]);

const cell = table.getCell(0, 2);

Borders

BorderStyle can be imported from docx. Size determines the thickness. HTML color can be a hex code or alias such as red.

cell.Borders.addTopBorder([BorderStyle], [SIZE], [HTML COLOR]);

cell.Borders.addBottomBorder([BorderStyle], [SIZE], [HTML COLOR]);

cell.Borders.addStartBorder([[BorderStyle]], [SIZE], [HTML COLOR]);

cell.Borders.addEndBorder([BorderStyle], [SIZE], [HTML COLOR]);

Example

import { BorderStyle } from "docx";

cell.Borders.addStartBorder(BorderStyle.DOT_DOT_DASH, 3, "green");
cell.Borders.addStartBorder(BorderStyle.DOT_DOT_DASH, 3, "#ff8000");

Set Width

import { WidthType } from "docx";

table.setWidth([WIDTH], [OPTIONAL WidthType. Defaults to DXA]);

For example:

table.setWidth(4535, WidthType.DXA);

Vertical Align

Sets the vertical alignment of the contents of the cell

import { VerticalAlign } from "docx";

cell.setVerticalAlign([VerticalAlign TYPE]);

For example, to center align a cell:

cell.setVerticalAlign(VerticalAlign.CENTER);

Rows

To get a row, use the getRow method on a table. There are a handful of methods which you can apply to a row which will be explained below.

table.getRow([ROW INDEX]);

Add paragraph to a cell

Once you have got the cell, you can add data to it with the addParagraph method.

cell.addParagraph(new Paragraph("Hello"));

Merge cells together

Merging on a row

First obtain the row, and call mergeCells(). The first argument is where the merge should start. The second argument is where the merge should end.

table.getRow(0).mergeCells([FROM INDEX], [TO INDEX]);

Example

This will merge 3 cells together starting from index 0:

table.getRow(0).mergeCells(0, 2);

Merging on a column

It has not been implemented yet, but it will follow a similar structure as merging a row.

Nested Tables

To have a table within a table

cell.addTable(new Table(1, 1));

Examples

Example

Source: https://github.com/dolanmiu/docx/blob/master/demo/demo4.ts