Skip to content

Commit

Permalink
Updated auto-paging text
Browse files Browse the repository at this point in the history
  • Loading branch information
GitBrent authored and GitBrent committed Nov 15, 2017
1 parent 0ce7f97 commit 4e1bfac
Showing 1 changed file with 8 additions and 5 deletions.
13 changes: 8 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -758,12 +758,9 @@ slide.addTable( [rows], {any Layout/Formatting OPTIONS} );
| :-------------- | :------ | :------ | :--------------------- | :--------------------------------------------------------- |
| `autoPage` | boolean | `true` | auto-page table | `true` or `false`. Ex: `{autoPage:false}` |
| `lineWeight` | float | 0 | line weight value | -1.0 to 1.0. Ex: `{lineWeight:0.5}` |
| `newPageStartY` | number/string | | starting `y` value for tables on new Slides | 0-n OR 'n%'. Ex:`{newPageStartY:0.5}` |

### Table Auto-Paging Notes
Tables will auto-page by default and the table on new Slides will use the current Slide's top `margin` value as the starting point for `y`.
Tables will retain their existing `x`, `w`, and `colW` values as they are continued onto subsequent Slides.
| `newPageStartY` | number/string | | starting `y` value for tables on new Slides | 0-n OR 'n%'. Ex:`{newPageStartY:0.5}` |

Option Details:
* `autoPage`: allows the auto-paging functionality (as table rows overflow the Slide, new Slides will be added) to be disabled.
* `lineWeight`: adjusts the calculated height of lines. If too much empty space is left under each table,
then increase lineWeight value. Conversely, if the tables are overflowing the bottom of the Slides, then
Expand All @@ -772,6 +769,12 @@ reduce the lineWeight value. Also helpful when using some fonts that do not have
you may place a table halfway down a Slide, but you wouldn't that to be the starting location for subsequent
tables. Use this option to ensure there is no wasted space and to guarantee a professional look.

### Table Auto-Paging Notes
* New slides will be created as tables overflow. The table will start at either `newPageStartY` (if present) or the Slide's top `margin`.
* Tables will retain their existing `x`, `w`, and `colW` values as they are rendered onto subsequent Slides.
* Auto-paging is not an exact science! Try using different `lineWeight` and Slide margin values if your tables are overflowing the Slide.
* There are many examples of auto-paging in the `examples` folder.

### Table Formatting Options
| Option | Type | Unit | Default | Description | Possible Values |
| :----------- | :------ | :----- | :-------- | :----------------- | :-------------------------------------------------------------------------------- |
Expand Down

0 comments on commit 4e1bfac

Please sign in to comment.