126

I want to avoid page break inside row of table in html, when I convert html to PDF by wkhtmltopdf. I use page-break-inside:avoid with table- its works, but I have so many rows, then not work. If set display of tr as block or some thing else then it change the formatting of table and insert double border. Or it is possible to insert the table header on each page, where the table was splitted.

7
  • 1
    Sorry, what is the problem when using page-break-inside: avoid;?
    – Christian
    Feb 15, 2012 at 7:29
  • 2
    @ChristianVarga when I use page-break-inside:avoid with tr, it is not work Feb 15, 2012 at 7:52
  • 1
    The page breaking with tables is quite buggy. Have a look at this JavaScript workaround code.google.com/p/wkhtmltopdf/issues/detail?id=168#c4
    – Jona
    Feb 15, 2012 at 9:30
  • 2
    actually I have tried page-break-inside:avoid with all the table elements like tr td, but it not worked. Feb 16, 2012 at 7:52
  • 3
    Yay Google for WebGL, blinding fast javascript, portable native client, but we still can't print data tables. Who would need to do that??? Only just about every business in the world. Incidentally, I tried to print a spreadsheet in google docs just now, and it consistently crashes my chrome. I think google docs prints via pdf. :/ May 20, 2014 at 8:05

13 Answers 13

98

You might try this with CSS:

<table class="print-friendly">
 <!-- The rest of your table here -->
</table>

<style>
    table.print-friendly tr td, table.print-friendly tr th {
        page-break-inside: avoid;
    }
</style>

Most CSS rules don't apply to <tr> tags directly, because of exactly what you pointed out above - they have a unique display style, which doesn't allow for these CSS rules. However, the <td> and <th> tags within them usually do allow this kind of specification - and you can easily apply such rules to ALL child-<tr>'s and <td>'s using CSS as shown above.

10
  • 25
    Unfortunately this doesn't (yet) work with webkit based browsers. Mar 12, 2013 at 19:17
  • 3
    Yes - there are some oddities. See @Peter's answer in this question: stackoverflow.com/questions/7706504/… for some more info. Mar 13, 2013 at 2:08
  • 3
    It only works if you take the entire table, not just tr/td: stackoverflow.com/a/13525758/729324 Dec 30, 2013 at 13:36
  • 1
    I've run into issues with this in IE8, possibly others, where it causes the entire table to try to fit on one page and cuts off any overflow. It also seemed to ignore the "scale to fit" option for these tables. Jan 23, 2014 at 17:00
  • 7
    @AttilaFulop Still? Your post is 3 years old and I still can't get it to work. Thanks
    – relipse
    May 13, 2016 at 21:41
40

The best way I have found to deal with this problem in webkit browsers is to put a div inside each td element and apply the page-break-inside: avoid style to the div, like this:

...
<td>
  <div class="avoid">
    Cell content.
  </div>
</td>
...
<style type="text/css">
  .avoid {
    page-break-inside: avoid !important;
    margin: 4px 0 4px 0;  /* to keep the page break from cutting too close to the text in the div */
  }
</style>

Even though Chrome supposedly does not recognize the 'page-break-inside: avoid;' property, this seems to keep the row content from being split in half by a page break when using wktohtml to generate PDFs. The tr element may hang over the page break a bit, but the div and anything inside it will not.

4
  • The margin: 4px 0 4px 0; did the trick for me, i was losing a record occasionally. Thanks
    – Wartodust
    Sep 24, 2015 at 7:26
  • A problem with this approach is that sometimes only a few cells of a row are broken to the next page, although each cell on its own will not get broken. Mar 22, 2017 at 12:27
  • @WorldSEnder Yes. Did you find a work around for this ?
    – ranjansaga
    Jun 30, 2017 at 11:49
  • 8
    Doesn't work. Nothing works. I tried every "solution" on the internet and there is no solution. We just have to accept crap software that can't even render a table. Oct 20, 2017 at 13:15
25

I used the 4px trick by @AaronHill above (link) and it worked really well! I used though a simpler css rule without needing to add a class to each <td> in the table.

@media print {
    table tbody tr td:before,
    table tbody tr td:after {
        content: "";
        height: 4px;
        display: block;
    }
}
1
  • 1
    This didn't work for me
    – mbomb007
    Mar 14, 2022 at 20:19
17

I've found a new way to solve this problem, at least for me (Chrome Version 63.0.3239.84 (Official Build) (64-bit) on MacOS Sierra)

Add a CSS rule to the parent table:

table{
    border-collapse:collapse;
}

and for the td:

tr td{
    page-break-inside: avoid;
    white-space: nowrap;
}

I actually found this solution on Stack Overflow, but it didn't show up in initial Google searches: CSS to stop page break inside of table row

Kudos to @Ibrennan208 for solving the problem!

1
  • 1
    its solved issue of cutting table row its break other design Oct 3, 2019 at 13:49
12

I have found that page-break-inside: avoid will not work if the any of the table's parent elements are display: inline-block or flex. Make sure all parent elements are display: block.

Also consider overriding table, tr, td's display styles with CSS grid for the print layout if you keep having issues with the table.

2
  • I fixed my multiple tables being broken up in weird places with overlapping text in Chrome, with help from this question: added display:block !important; to body and div when printing, as well as page-break-inside: avoid; to table. Dec 21, 2020 at 11:16
  • I was about to give up but this answer give me the right threat to pull on. I am using tailwind and had flex classes applied to some containing elements. I added print:block to those and my table suddenly started respecting the page-break-inside directives. Thank you! Jan 4 at 3:39
10

Using CSS page-break-inside won't work (this is a webkit browser issue).

There is a wkhtmltopdf JavaScript table splitting hack which breaks a long table into smaller tables automatically depending on the page size you specify (rather than page breaking after a static value of x rows): https://gist.github.com/3683510

2
  • This js hack will work if I just want print webpage without wkhtmltopdf?
    – 120196
    Aug 19, 2016 at 3:50
  • This is the only one that worked for me. Also works with HTML-PDF library.
    – gilbert-v
    Jan 15, 2020 at 13:39
10

The only way I found to work was to place each TR element inside it's own TBODY element, and apply the page break rules to the TBODY element via css

3
8

I wrote the following JavaScript based on Aaron Hill's answer:

//Add a div to each table cell so these don't break across pages when printed
//See http://stackoverflow.com/a/17982110/201648
$(document).ready(function () {
    var ctlTd = $('.dontSplit td');
    if (ctlTd.length > 0)
    {
        //console.log('Found ctlTd');
        ctlTd.wrapInner('<div class="avoidBreak" />');
    }
});

Where dontSplit is the class of the table where you don't want the td's to split across pages. Use this with the following CSS (again, attributed to Aaron Hill):

 .avoidBreak {
    page-break-inside: avoid !important;
    margin: 4px 0 4px 0;  /* to keep the page break from cutting too close to the text in the div */
  }

This appears to be working nicely in the latest version of Chrome.

2
  • 1
    I am rendering large tables into PDF format using wkhtmltopdf, and this is the only solution that yielded acceptable results. It could be better (Webkit doesn't repeat cell borders after a page break), but at least the content is there. Thanks! Jan 1, 2014 at 6:33
  • This doesn't work when printing using Ctrl+P
    – mbomb007
    Mar 15, 2022 at 13:26
8

The 2020 solution

The only thing I could consistently get to work on all browsers is to put each row inside its own table element. This also works with node HTML-PDF. Then just set everything to page-break-inside: avoid.

table,
tr,
td,
div {
    page-break-inside: avoid;
}

The only disadvantage to this is that you must manually set the width of the columns, otherwise it looks rather strange. The following worked well for me with two columns.

td:first-child { width: 30% }
td:last-child { width: 70% }


Example

<table>
  <tr>
    <td>Forename</td>
    <td>John</td>
  </tr>
</table>
<table>
  <tr>
    <td>Surname</td>
    <td>Piper</td>
  </tr>
</table>
<table>
  <tr>
    <td>Website</td>
    <td>desiringgod.org</td>
  </tr>
</table>
5
  • Could you provide an example table HTML? Thanks. Aug 20, 2020 at 17:16
  • Thank you, @gilbert-v for the edit with example. I will try this. Aug 24, 2020 at 17:11
  • 1
    This is the solution I end up using. I need to group 2 to 4 rows that represents an entity of data, so page breaks only between these groups of rows, but not inside. I put each group into separate table. The only issue here is getting consistent column widths across all tables. Sep 2, 2021 at 13:28
  • 1
    This has been replaced with break-inside developer.mozilla.org/en-US/docs/Web/CSS/break-inside Aug 2, 2022 at 17:42
  • It has worked like a charm for my case. Thanks a lot.
    – Umar Niazi
    Feb 17 at 7:29
7

Try with

white-space: nowrap; 

style to td to avoid it breaking on new lines.

1
  • 1
    A lot simpler than the other solutions. Is this a new thing?
    – bendecko
    Dec 26, 2016 at 17:19
0

This is an old question but I got into this same error recently. The problem in my case was related to Bootstrap's table-responsive class, which was accidentally being used on <table> element.

So, if you have the same issue, try removing table-responsive from <table> class when calling wkhtmltopdf.

0

To avoid wrong page breaks with table rows, need to use the below CSS while generating PDF files from HTML.
table tr { page-break-inside: avoid! important;margin: 4px 0 4px 0;} enter image description here

0

This is what worked for me:

@media all {
  table.report { page-break-after:auto }
  table.report tr    { page-break-inside:avoid; page-break-after:auto }
  table.report td    { page-break-inside:avoid; page-break-after:auto }
  table.report thead { display:table-header-group }
  table.report tfoot { display:table-footer-group }
}

Not the answer you're looking for? Browse other questions tagged or ask your own question.