![\"pdfkit-table](\"https://img.shields.io/badge/npm-pdfkit--table-red?style=for-the-badge&logo=npm\"){kind=icon}
\n \n \n \n ![\"pdfkit-table](\"https://img.shields.io/badge/GitHub-pdfkit--table-black?style=for-the-badge&logo=github\"){kind=icon}
\n \n\n
\n
\n ![\"pdfkit-table](\"https://github.com/natancabral/pdfkit-table/blob/main/example/logo.png\"){kind=logo}
\n
\n
\n ![\"Buy](\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\")
\n
\n
\n
![](\"https://github.com/natancabral/pdfkit-table/blob/main/example/pdf-sample.png\"/)
\n\n## Install \n\n[](https://www.npmjs.com/package/pdfkit-table)\n\n\n[](https://yarnpkg.com/package/pdfkit-table)\n```bash\nyarn add pdfkit-table\n```\n\n[](https://www.npmjs.com/package/pdfkit-table)\n```bash\nnpm install pdfkit-table\n```\n\n![](\"https://github.com/natancabral/pdfkit-table/blob/main/example-server/assets/server-terminal.png\")
\n\nPipe the PDFKit stream **once** (to `res` or to `fs`). Avoid `doc.pipe(fs)` and `doc.pipe(res)` on the same document.\n\n```js\napp.get('/create-pdf', async (req, res) => {\n const PDFDocument = require('pdfkit-table');\n\n res.setHeader('Content-Type', 'application/pdf');\n\n const doc = new PDFDocument({ margin: 30, size: 'A4' });\n doc.pipe(res);\n\n const table = {\n headers: ['Country', 'Conversion rate'],\n rows: [['Switzerland', '12%']],\n };\n\n await doc.table(table, { width: 300 });\n doc.end();\n});\n```\n\nSee also [`example/document-00-server.js`](https://github.com/natancabral/pdfkit-table/blob/main/example/document-00-server.js).\n\n### Example 1 — simple array (`rows`)\n\n```js\n;(async () => {\n const table = {\n title: 'Title',\n subtitle: 'Subtitle',\n headers: ['Country', 'Conversion rate', 'Trend'],\n rows: [\n ['Switzerland', '12%', '+1.12%'],\n ['France', '67%', '-0.98%'],\n ['England', '33%', '+4.44%'],\n ],\n };\n\n await doc.table(table, { width: 300 });\n // …or explicit column widths (pt): { columnsSize: [200, 100, 100] }\n\n doc.end();\n})();\n```\n\n\n### Example 2 — `data` + `rows`, custom renderers\n\n```js\n;(async () => {\n const table = {\n title: 'Title',\n subtitle: 'Subtitle',\n headers: [\n { label: 'Name', property: 'name', width: 60, renderer: null },\n { label: 'Description', property: 'description', width: 150, renderer: null },\n { label: 'Price 1', property: 'price1', width: 100, renderer: null },\n { label: 'Price 2', property: 'price2', width: 100, renderer: null },\n { label: 'Price 3', property: 'price3', width: 80, renderer: null },\n {\n label: 'Price 4',\n property: 'price4',\n width: 43,\n renderer: (value, indexColumn, indexRow, row, rectRow, rectCell) =>\n `U$ ${Number(value).toFixed(2)}`,\n },\n ],\n data: [\n {\n name: 'Name 1',\n description:\n 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean mattis ante in laoreet egestas. ',\n price1: '$1',\n price3: '$ 3',\n price2: '$2',\n price4: '4',\n },\n {\n options: { fontSize: 10, separation: true },\n name: 'bold:Name 2',\n description: 'bold:Lorem ipsum dolor.',\n price1: 'bold:$1',\n price3: { label: 'PRICE $3', options: { fontSize: 12 } },\n price2: '$2',\n price4: '4',\n },\n ],\n rows: [\n [\n 'Apple',\n 'Nullam ut facilisis mi. Nunc dignissim ex ac vulputate facilisis.',\n '$ 105,99',\n '$ 105,99',\n '$ 105,99',\n '105.99',\n ],\n ],\n };\n\n await doc.table(table, {\n prepareHeader: () => doc.font('Helvetica-Bold').fontSize(8),\n prepareRow: (row, indexColumn, indexRow, rectRow, rectCell) => {\n doc.font('Helvetica').fontSize(8);\n if (indexColumn === 0) doc.addBackground(rectRow, 'blue', 0.15);\n },\n });\n\n doc.end();\n})();\n```\n\n### Example 3 — JSON **string** (`JSON.stringify` → `doc.table`)\n\nString renderers belong on **`headers[].renderer`** when you need serialized JSON (`@deprecated` — prefer real functions).\n\n```js\n;(async () => {\n const tableJson = JSON.stringify({\n headers: [\n { label: 'Name', property: 'name', width: 100 },\n { label: 'Age', property: 'age', width: 100 },\n {\n label: 'Year',\n property: 'year',\n width: 100,\n renderer:\n 'function(value, indexColumn, indexRow){ return value + \"(\" + (1 + indexRow) + \")\"; }',\n },\n ],\n data: [\n { name: 'bold:Name 1', age: 'Age 1', year: 'Year 1' },\n { name: 'Name 2', age: 'Age 2', year: 'Year 2' },\n { name: 'Name 3', age: 'Age 3', year: 'Year 3' },\n ],\n rows: [['Name 4', 'Age 4', 'Year 4']],\n options: { width: 300 },\n });\n\n await doc.table(tableJson); // parses JSON; merges embedded `options`\n doc.end();\n})();\n```\n\n### Example 4 — JSON file (object **or** array)\n\nSee [`example/table.json`](https://github.com/natancabral/pdfkit-table/blob/main/example/table.json).\n\n```js\n;(async () => {\n const json = require('./table.json');\n\n if (Array.isArray(json)) {\n await doc.tables(json);\n } else {\n await doc.table(json, json.options ?? {});\n }\n\n doc.end();\n})();\n```\n\n\n## Table\n\n- Array.<object> | JSON\n - headers Array.<object> | Array.[]\n - label String\n - property String\n - width Number\n - align String\n - valign String\n - headerColor String\n - headerOpacity Number\n - headerAlign String\n - columnColor or ~~backgroundColor~~: String\n - columnOpacity or ~~backgroundOpacity~~: Number\n - padding Number | Array | Object\n - renderer Function function( value, indexColumn, indexRow, row, rectRow, rectCell ) { return value }\n - data Array.<object>\n - ~~datas~~ Array.<object> (deprecated — use `data`)\n - rows Array.[]\n - title String | Object\n - subtitle String | Object\n - options Object\n\n### Headers\n\n| Properties | Type | Default | Description |\n-----------------------|-----------------------|--------------------|-------------------|\n| **label** | String | undefined | description |\n| **property** | String | undefined | id |\n| **width** | Number | undefined | width of column |\n| **align** | String | left | alignment |\n| **valign** | String | undefined | vertical alignment. ex: valign: \"center\"|\n| **headerColor** | String | grey or #BEBEBE | color of header |\n| **headerOpacity** | Number | 0.5 | opacity of header |\n| **headerAlign** | String | left | only header |\n| **columnColor** or ~~backgroundColor~~ | String | undefined | color of column |\n| **columnOpacity** or ~~backgroundOpacity~~| Number | undefined | opacity of column |\n| **padding** | `Number | Array | Object` | `0` | cell padding — overrides global `padding`. CSS shorthand: `[top, right, bottom, left]` |\n| **renderer** | Function | Function | function( value, indexColumn, indexRow, row, rectRow, rectCell ) { return value } |\n\n\n#### Simple headers example\n\n```js\nconst table = {\n // simple headers only with ROWS (not DATA) \n headers: ['Name', 'Age'],\n // simple content\n rows: [\n ['Jack', '32'], // row 1\n ['Maria', '30'], // row 2\n ]\n};\n```\n\n#### Complex headers example\n\n```js\nconst table = {\n // complex headers work with ROWS and DATA \n headers: [\n { label:\"Name\", property: 'name', width: 100, renderer: null },\n { label:\"Age\", property: 'age', width: 100, renderer: (value) => `U$ ${Number(value).toFixed(1)}` },\n ],\n // complex content\n data: [\n { name: 'bold:Jack', age: 32, },\n // age is object value with style options\n { name: 'Maria', age: { label: 30 , options: { fontSize: 12 }}, },\n ],\n // simple content (works fine!)\n rows: [\n ['Jack', '32'], // row 1\n ['Maria', '30'], // row 2\n ]\n};\n\n```\n\n### Options\n\n| Property | Type | Default | Description |\n|---|---|---|---|\n| **title** | `String | Object` | undefined | table title |\n| **subtitle** | `String | Object` | undefined | table subtitle |\n| **width** | `Number` | undefined | total table width |\n| **x** | `Number | null` | undefined | x position. Pass `null` or `-1` to reset to left margin |\n| **y** | `Number` | undefined | y position (top) |\n| **divider** | `Object` | — | divider line config `{ header, horizontal, vertical }` |\n| **columnsSize** | `Array` | `[]` | column widths (simple tables) |\n| **columnSpacing** | `Number` | `3` | vertical space between rows |\n| **padding** | `Number | Array | Object` | `0` | cell padding — CSS shorthand `[top, right, bottom, left]` |\n| **addPage** | `Boolean` | `false` | start table on a fresh page |\n| **hideHeader** | `Boolean` | `false` | hide the header row |\n| **minRowHeight** | `Number` | `0` | minimum row height in points |\n| **useSafelyMarginBottom** | `Boolean` | `true` | enable proactive page-break before rows that do not fit |\n| **pageBreakThreshold** | `Number` (0–1) | `0.8` | fraction of page height below which a row triggers a proactive page break. Rows **taller** than `pageContentHeight × threshold` render in-place without an empty gap. Default `0.8` means only rows that fill < 80 % of the page are moved to a new page. |\n| **endOfPageThreshold** | `Number` (0–1) | — | fraction of usable page height defining \"near the bottom\". A proactive break fires when remaining space ≤ this fraction AND the row fits within `pageBreakThreshold`. Default: page bottom margin |\n| **keepRowsTogether** | `Boolean` | `false` | when `true`, every row starts at the current cursor — no proactive page breaks. Ideal for tables where every cell contains multi-page text. |\n| **absolutePosition** | `Boolean` | `false` | use absolute x / y coordinates |\n| **prepareHeader** | `Function` | — | `(this: PDFDoc) => void` — called before rendering the header row |\n| **prepareRow** | `Function` | — | `(row, indexColumn, indexRow, rectRow, rectCell) => void` — called before each cell |\n\n#### Options example\n\n```js\nconst options = {\n title: \"Title\", // or { label: 'Title', fontSize: 18, color: 'blue', fontFamily: \"./fonts/type.ttf\" }\n subtitle: \"Subtitle\",\n width: 500, // A4 portrait ≈ 595 pt wide\n x: 0, // pass null or -1 to reset to left margin\n y: 0,\n divider: {\n header: { disabled: false, width: 2, opacity: 1 },\n horizontal: { disabled: false, width: 0.5, opacity: 0.5 },\n },\n padding: 5, // or [top, right, bottom, left] like CSS\n columnSpacing: 5,\n hideHeader: false,\n minRowHeight: 0,\n prepareHeader: () => doc.font(\"Helvetica-Bold\").fontSize(8),\n prepareRow: (row, indexColumn, indexRow, rectRow, rectCell) =>\n doc.font(\"Helvetica\").fontSize(8),\n}\n```\n\n#### Page-break control\n\n```js\n// Option A — pageBreakThreshold\n// Only move rows to a new page if they fit in < 60 % of the page.\n// Rows taller than 60 % start in-place and flow naturally across pages.\nawait doc.table(table, {\n pageBreakThreshold: 0.6,\n prepareHeader: () => doc.font('Helvetica-Bold').fontSize(8),\n prepareRow: () => doc.font('Helvetica').fontSize(8),\n});\n\n// Option B — keepRowsTogether\n// Never insert a proactive page break — every row starts where the cursor is.\n// Best for tables where every cell contains long multi-page text.\nawait doc.table(table, {\n keepRowsTogether: true,\n prepareHeader: () => doc.font('Helvetica-Bold').fontSize(8),\n prepareRow: () => doc.font('Helvetica').fontSize(8),\n});\n```\n\n| `pageBreakThreshold` | Effect |\n|---|---|\n| `0.8` (**default**) | Only rows shorter than 80 % of the page are moved proactively — tall rows stay in-place and overflow naturally. Equivalent to \"only `addPage()` breaks the page for big rows.\" |\n| `1.0` | Old behaviour — every row that doesn't fit in remaining space gets a page break, regardless of height. |\n| `0.6` | Only move if row < 60 % of page height — tall rows flow in-place |\n| `0.0` | Never move any row (same as `keepRowsTogether: true`) |\n\n#### `doc.checkPageBreak(minHeight?)` — prevent orphaned titles\n\nA chainable helper method available on any `PDFDocumentWithTables` instance.\nCall it **before** a section title, heading, or `doc.table()` to ensure there\nis enough room on the current page. If the remaining vertical space is less\nthan `minHeight`, a new page is added automatically.\n\n| Argument | Type | Default | Meaning |\n|---|---|---|---|\n| *(none)* | — | 10 % of usable height | add a page if less than 10 % remains |\n| `0 < n ≤ 1` | `Number` (fraction) | — | treat as percentage of usable page height |\n| `n > 1` | `Number` (points) | — | minimum absolute space required (pt) |\n\nReturns `this` so calls can be chained fluently.\n\n```js\n// Default — add a page if less than 10 % of usable height remains\ndoc.checkPageBreak();\n\n// At least 80 pt must remain, otherwise add a new page\ndoc.checkPageBreak(80);\n\n// At least 15 % of the usable page height must remain\ndoc.checkPageBreak(0.15);\n\n// Typical chained usage — keeps a title and its table together\ndoc\n .checkPageBreak(0.2) // ensure 20 % space before writing the title\n .fontSize(11)\n .font('Helvetica-Bold')\n .text('Section Title')\n .font('Helvetica')\n .fontSize(9)\n .moveDown(0.3);\n\nawait doc.table(myTable, opts);\n```\n\n#### Options Row\n\n- separation {Boolean}\n- color {String}\n- columnColor {String}\n- columnOpacity {Number}\n- backgroundColor {String} (deprecated — use `columnColor`)\n- backgroundOpacity {Number} (deprecated — use `columnOpacity`)\n- background {Object} `{ color, opacity }` (deprecated — use `columnColor` / `columnOpacity`)\n- fontSize {Number}\n- fontFamily {String}\n\n```js\ndata: [\n // options row\n { name: 'Jack', options: { fontSize: 10, fontFamily: 'Courier-Bold', separation: true } },\n]\n``` \n\n- String\n - **bold:** \n - 'bold:Jack'\n - **size{n}:** \n - 'size11:Jack'\n - 'size20:Jack'\n\n```js\ndata: [\n // bold\n { name: 'bold:Jack' },\n // size{n}\n { name: 'size20:Maria' },\n { name: 'size8:Will' },\n // normal\n { name: 'San' },\n]\n``` \n\n#### Options Cell\n\n- fontSize {Number}\n- fontFamily {String}\n- color {String}\n\n```js\ndata: [\n // options cell — value is { label, options }\n {\n name: { label: 'Jack', options: { fontSize: 10, fontFamily: 'Courier-Bold' } },\n },\n]\n``` \n\n#### Fonts Family\n\n- Courier\n - Courier-Bold\n - Courier-Oblique\n - Courier-BoldOblique\n- Helvetica\n - Helvetica-Bold\n - Helvetica-Oblique\n - Helvetica-BoldOblique\n- Symbol\n- Times-Roman\n - Times-Bold\n - Times-Italic\n - Times-BoldItalic\n- ZapfDingbats\n\n## ToDo\n\n- [Suggestions / Issues / Fixes](https://github.com/natancabral/pdfkit-table/issues)\n- striped {Boolean} (corsimcornao)\n- colspan - the colspan attribute defines the number of columns a table cell should span.\n- sample with database\n- margin: marginBottom before, marginTop after\n\n## Changelogs\n\n### 0.2.11\n- accept relative column sizes: (null, undefined or '*') [JS](https://github.com/natancabral/pdfkit-table/blob/main/example/document-11-many-lines.js) | [PDF](https://github.com/natancabral/pdfkit-table/raw/main/example/document-11-many-lines.pdf)\n - columnsSize: [50, 300, null],\n - columnsSize: [50, 300, undefined, 200],\n - columnsSize: [100, '*', 50, null],\n\n\n### 0.2.9\n\n- CG memory\n - Thanks [spanwair-r](https://github.com/spanwair-r)\n```js\ndoc.image('./chart-large.png', 50, 200, { width: 400 });\n// Do not use in repeated images. ex: brand\n// Use in large images\ndoc.purgeImage('./chart-large.png');\n```\n\n\n### 0.2.8\n\n- RTL\n - Thanks [moshfeu](https://github.com/moshfeu)\n```js\noptions: {\n rtl: true, // boolean\n}\n```\n\n### 0.2.2\n\n- Fix\n - Thanks [***@mar10-emil***](https://github.com/mar10-emil)\n```js\n- added render queue onAddPage\n- setting renders queue in constructor\n- fixed override for addPage\n- added debugging logs\n- logging for deb debugging\n- removed event handler\n- added callback\n- rendering set in onFirePageAdded\n- removed logs and disabled event triggers\n- logging for debugging\n- testing sections order\n- refactored code \n```\n\n### 0.2.0\n\n#### New features\n\n- **Full TypeScript rewrite** — source moved to `src/` (`types.ts`, `document.ts`, `index.ts`). Ships compiled `dist/` + `.d.ts` declarations. Backward-compatible type aliases preserved (`Options`, `Data`, `Title`, `Divider`, …).\n- **ESM `import` support** — `import PDFDocument from 'pdfkit-table'` works in Node.js ESM, TypeScript, and bundlers (Vite, Webpack). `package.json` now includes an `\"exports\"` map.\n- **Dependency injection** — `createPdfDocumentWithTables(PDFKit)` lets you plug in your own `pdfkit` version or fork.\n- **`pageBreakThreshold`** option (Number 0–1, default `0.8`) — controls when a tall row is moved to a new page. Rows taller than `80 %` of the page start in-place and overflow naturally; only shorter rows are moved proactively. Set to `1.0` to restore the old always-break behaviour.\n- **`keepRowsTogether`** option (Boolean, default `false`) — disables all proactive page breaks; every row starts at the current cursor and overflows naturally.\n- **`doc.checkPageBreak(minHeight?)`** — new chainable helper that adds a page when remaining vertical space is less than `minHeight` (default: 10 % of usable height; fractions ≤ 1 are treated as percentages; values > 1 as absolute points). Ideal for keeping section titles and their tables on the same page.\n\n#### Bug fixes\n\n- **`pageAdded` event listener** — `onFirePageAdded` was defined but never registered; repeated header rendering now works correctly on overflow pages.\n- **Font mismatch in height calculation** — `computeRowHeight` now applies `prepareRow` before `heightOfString`, so measured height matches rendered height (eliminates gap between text and divider line).\n- **Page-break forced for multi-page rows** — rows taller than one full page no longer trigger a forced new page before every row.\n- **Text style after mid-row page break** — continued text on overflow pages no longer inherits the header font / color (`restoreRowStyle` mechanism).\n- **Text overlap with header on overflow pages** — fixed by temporarily raising `page.margins.top` after the header is drawn so PDFKit's `LineWrapper.nextSection()` positions continued text below the header.\n- **`prepareCellPadding` case 3** — corrected CSS shorthand: `[top, right, bottom, left=right]` (was incorrectly `[top, right, bottom, 0]`).\n- **`eval()` in renderer** — replaced with `new Function()` (CSP-safe). String renderers are now `@deprecated`.\n- **`String.substr`** — replaced deprecated `substr(4, 2)` with `slice(4, 6)`.\n- **Weak types** — `any` removed from `prepareRowOptions`, `prepareRowBackground`, `computeRowHeight`; replaced with `unknown` + runtime guards and a `RowHeightInput` union.\n\n\n### 0.1.90\n\n- Add options minRowHeight\n - Thanks LouiseEH ***@LouiseEH***\n```js\n options: {\n minRowHeight: 30, // pixel\n }\n```\n\n### 0.1.89\n\n- Fix first line height\n - Thanks José Luis Francisco ***@JoseLuis21*** \n\n### 0.1.88\n\n- Fix header font family or title object\n - Thanks ***@RastaGrzywa***\n```js\nlet localType = \"./font/Montserrat-Regular.ttf\";\nconst table = {\n title: { label: 'Title Object 2', fontSize: 30, color: 'blue', fontFamily: localType },\n}\n```\n\n### 0.1.87\n\n- Add options hideHeader\n - Thanks Ville ***@VilleKoo***\n```js\n options: {\n hideHeader: true,\n }\n```\n\n### 0.1.86\n\n- TypeScript (ts) interface (index.ts)\n - Thanks Côte Arthur ***@CoteArthur***\n\n### 0.1.83\n\n- Avoid a table title appearing alone\n - Thanks Alexis Arriola ***@AlexisArriola***\n- Problem with long text in cell spreading on several pages\n - Thanks Ed ***@MeMineToMe***\n\n### 0.1.72\n\n- Add ***Divider Lines*** on options\n```js\n options: {\n // divider lines\n divider: {\n header: {disabled: false, width: 0.5, opacity: 0.5},\n horizontal: {disabled: true, width: 0.5, opacity: 0.5},\n },\n }\n```\n - Thanks Luc Swart ***@lucswart***\n\n### 0.1.70\n\n+ Fix ***y*** position.\n - Thanks Nabil Tahmidul Karim ***@nabiltkarim***\n\n### 0.1.68\n\n+ Added ***Promise***. table is a Promise();\n - Async/Await function \n```js\n;(async function(){\n // create document\n const doc = new PDFDocument({ margin: 30, });\n // to save on server\n doc.pipe(fs.createWriteStream(\"./my-table.pdf\"));\n // tables\n await doc.table(table, options);\n await doc.table(table, options);\n await doc.table(table, options);\n // done\n doc.end();\n})();\n```\n\n+ Added ***callback***. \n```js\n ~~doc.table(table, options, callback)~~;\n```\n\n### 0.1.63\n\n+ Added ***valign*** on headers options. (ex: valign:\"center\")\n+ Added ***headerAlign***, alignment only to header.\n ```js\n headers: [\n {label:\"Name\", property:\"name\", valign: \"center\", headerAlign:\"right\", headerColor:\"#FF0000\", headerOpacity:0.5 }\n ]\n ```\n - Thanks ***@DPCLive***\n\n### 0.1.60\n\n+ Add callback on addBackground function, add .save() and .restore() style.\n+ Header font color\n - Thanks ***@dev-fema***\n\n### 0.1.59\n\n+ Add padding\n\n### 0.1.57\n\n+ Header color and opacity\n ```js\n headers: [\n {label:\"Name\", property:\"name\", headerColor:\"#FF0000\", headerOpacity:0.5 }\n ]\n ```\n - Thanks ***Albert Taveras*** @itsalb3rt\n\n\n### 0.1.55\n\n+ Align on headers\n ```js\n headers: [\n {label:\"Name\", property:\"name\", align:\"center\"}\n ]\n ```\n - Thanks ***Andrea Fucci***\n\n### 0.1.49\n\n+ Max size page\n\n### 0.1.48\n\n+ Header height size\n+ Separate line width\n\n### 0.1.47\n\n+ addHeader() function on all add pages\n - Thanks Anders Wasen ***@QAnders***\n\n### 0.1.46\n\n+ addBackground() function to node 8\n - Thanks ***@mehmetunubol***\n\n### 0.1.45\n\n+ Add **rectCell** on renderer\n - renderer = ( value, indexColumn, indexRow, row, rectRow, rectCell ) => {}\n - Thanks ***Eduardo Miranda***\n\n### 0.1.44\n\n+ Fix paddings and distances\n\n### 0.1.43\n\n+ Remove **rowSpacing**\n+ Fix **columnSpacing**\n\n### 0.1.41\n\n+ **Background** color on header to colorize ***column***\n - headers: [\n { label:\"Name\", property: 'name', ***backgroundColor: 'red', backgroundOpacity: 0.5*** },\n { label:\"Age\", property: 'age', ***background: { color: 'green', opacity: 0.5 } }***,\n ]\n+ **Background** color inside row options data\n - data: [\n { name:\"My Name\", age: 20, ***options: { backgroundColor: 'red', backgroundOpacity: 0.5 }*** },\n { name:\"My Name\", age: 20, ***options: { background: { color: 'green', opacity: 0.5 } }*** },\n ]\n+ **Background** color inside cell options data\n - data: [\n { name:{ label: \"My Name\", age: 20, ***options: { backgroundColor: 'red', backgroundOpacity: 0.5 }*** }},\n { name:{ label: \"My Name\", age: 20, ***options: { background: { color: 'green', opacity: 0.5 } }*** }},\n ]\n\n### 0.1.39\n\n+ **addBackground** {Function} - Add background peer line. \n - doc.addBackground( {x, y, width, height}, fillColor, opacity, callback );\n+ **prepareRow** {Function}\n - const options = { prepareRow: (row, indexColumn, indexRow, rectRow, rectCell) => { indexColumn === 0 && doc.addBackground(rectRow, 'red', 0.5) } }\n\n### 0.1.38\n\n+ **tables** {Function} - Add many tables. \n - doc.tables([ table0, table1, table2, ... ]);\n\n### 0.1.37\n\n+ **addPage** {Boolean} - Add table on new page.\n - const options = { addPage: true, }; \n\n### 0.1.36\n\n+ Fix position x, y of title\n+ **options.x**: **null** | **-1** // reset position to margins.left\n\n### 0.1.35\n\n+ add **title** {String}\n - const table = { title: \"\", };\n - const options = { title: \"\", };\n+ add **subtitle** {String}\n - const table = { subtitle: \"\", };\n - const options = { subtitle: \"\", };\n\n### 0.1.34\n\n+ add **columnsSize** on options = {} // only to simple table\n\n### 0.1.33\n\n+ Function **tableToJson**\n - import {tableToJson} from 'pdfkit-table';\n - const table = tableToJson('#id_table'); {Object}\n+ Function **allTablesToJson**\n - import {allTablesToJson} from 'pdfkit-table';\n - const tables = allTablesToJson(); {Array}\n\n### 0.1.32\n\n+ spacing cell and header alignment\n+ **Thank you, contributors!**\n\n### 0.1.31\n\n+ renderer function on json file. { \"renderer\": \"function(value, icol, irow, row){ return (value+1) + `(${(irow+2)})`; }\" }\n+ fix width table and separation lines size \n\n## License\n\nThe MIT License.\n\n## Author\n\n\n ![](\"https://github.com/natancabral.png?s=100\") \n | \n \n Natan Cabral \n natancabral@hotmail.com \n https://github.com/natancabral/\n | \n