mPDF Manual – Tables

Auto-layout algorithm

Algorithm used for autosizing tables

For non-rotated tables

  • If the minimum width of the table is greater than the page width, the table is resized to fit the minimum width = page width.* (Minimum width is calculated when each cell accommodates longest word (allowing for nowrap /  )) This disregards the value of autosize.
  • If the height of the highest row is greater than a full page height, the table is resized to fit the highest row < page height. (This is an approximation, as it scales the table size by a factor of less than sqrt(maxrow / pageheight) ). This disregards the value of autosize.
  • The table is now printed - allowing it to break across pages - unless page-break-inside: avoid is set.
  • If page-break-inside: avoid is set:
    • if table height is greater than a full page, the size is reduced to fit the table on a full page, and printed. (This is an approximation, as it scales the table size by a factor of less than sqrt(tableheight / pageheight) ). This disregards the value of autosize.
    • if table height is greater than the remaining space on the page (but less than a full page):
      • if the table size can be reduced to fit in the remaining space, AND respect the autosize value (i.e. maximum scaling factor), it is scaled and printed in the remaining page space;
      • if not, a new page is started and the table is printed using the scaling factor set by 1 or 2.

If there is a conflict between respecting page-break-inside: avoid and respecting the maximum value allowed for autosize, the configurable variable tableMinSizePriority will determine which factor takes priority. (mPDF ≥ 4.6)

For rotated tables

  • If the whole table fits into the remaining height left on the page, print as it is.
  • If the minimum width of the table is greater than the page height remaining, the table is resized to fit the minimum width = page height remaining, as long as the whole table fits, and the scaling factor is within the value of autosize. (Minimum width is calculated when each cell accommodates longest word - allowing for nowrap, &nbsp; etc.)
  • Else a new page is started, and the algorithm above followed (obviously containing size width becomes height etc.)

* From mPDF 4.3, this can be overridden using CSS property overflow: <table style="overflow: auto | hidden | visible | wrap">   Default: auto, described above.

Fork me on GitHub