You can avoid the page breaks inside HTML elements in the generated PDF document by setting the PdfDocumentOptionsAvoidHtmlElementsBreakSelectors API property. An object of PdfDocumentOptions type is exposed by the HtmlToPdfConverterPdfDocumentOptions property. If a HTML element is selected by this selector and the HTML element would be normally rendered on two PDF pages then converter will try to move the rendering of the element to the beginning of the next PDF page. This is possible only if the element height is smaller than the next PDF page height.
Code Sample - Avoid Page Breaks Inside HTML Elements Using API
C#
protected void convertToPdf() { // Get the server IP and port String serverIP = textBoxServerIP.Text; uint serverPort = uint.Parse(textBoxServerPort.Text); // Create a HTML to PDF converter object HtmlToPdfConverter htmlToPdfConverter = null; if (radioButtonUseTcpService.Checked) htmlToPdfConverter = new HtmlToPdfConverter(serverIP, serverPort); else htmlToPdfConverter = new HtmlToPdfConverter(true, textBoxWebServiceUrl.Text); // Set optional service password if (textBoxServicePassword.Text.Length > 0) htmlToPdfConverter.ServicePassword = textBoxServicePassword.Text; // Set license key received after purchase to use the converter in licensed mode // Leave it not set to use the converter in demo mode htmlToPdfConverter.LicenseKey = "4W9+bn19bn5ue2B+bn1/YH98YHd3d3c="; // Set an adddional delay in seconds to wait for JavaScript or AJAX calls after page load completed // Set this property to 0 if you don't need to wait for such asynchcronous operations to finish htmlToPdfConverter.ConversionDelay = 2; // Set the CSS selectors of the HTML elements for which to avoid page breaks inside in the generated PDF document htmlToPdfConverter.PdfDocumentOptions.AvoidHtmlElementsBreakSelectors = new string[] { htmlElementsSelectorTextBox.Text }; byte[] outPdfBuffer = null; if (convertHtmlRadioButton.Checked) { string htmlWithForm = htmlStringTextBox.Text; string baseUrl = baseUrlTextBox.Text; // Convert the HTML string to a PDF document in a memory buffer outPdfBuffer = htmlToPdfConverter.ConvertHtml(htmlWithForm, baseUrl); } else { string url = urlTextBox.Text; // Convert the HTML page to a PDF document in a memory buffer outPdfBuffer = htmlToPdfConverter.ConvertUrl(url); } }
HTML Code of the Converted Page
XML
<!DOCTYPE html> <html> <head> <title>Avoid Page Breaks Inside HTML Elements usig API</title> </head> <body style="margin: 0px; font-family: 'Times New Roman'; font-size: 14px"> <table id="page_break_inside_avoid_table" style="width: 1024px; font-family: 'Times New Roman'; font-size: 16px"> <!-- The automaticaly repeated table header --> <!-- To disable the repeating of the header add style="display: table-row-group" to thead --> <thead> <tr> <td colspan="2"> <table style="border-bottom: 1px solid gray; width: 100%;"> <tr> <td style="width: 200px"> <img alt="Logo Image" style="float: left; width: 200px" src="img/logo.jpg" /> </td> <td style="text-align: right; font-size: 22px; font-weight: bold; color: navy">Repeated Table Header </td> </tr> </table> </td> </tr> </thead> <tr> <td style="background-color: silver; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">1</td> <td style="background-color: whitesmoke; font-weight: normal; font-style: normal; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. </td> </tr> <tr> <td style="background-color: lightgray; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">2</td> <td style="font-weight: bold; font-style: normal; background-color: oldlace; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum claritatem. Investigationes demonstraverunt lectores legere me lius quod ii legunt saepius. Claritas est etiam processus dynamicus, qui sequitur mutationem consuetudium lectorum. Mirum est notare quam littera gothica, quam nunc putamus parum claram, anteposuerit litterarum formas humanitatis per seacula quarta decima et quinta decima. Eodem modo typi, qui nunc nobis videntur parum clari, fiant sollemnes in futurum. </td> </tr> <tr> <td style="background-color: gainsboro; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">3</td> <td style="font-weight: normal; font-style: italic; background-color: azure; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. </td> </tr> <tr> <td style="background-color: whitesmoke; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">4</td> <td style="font-weight: bold; font-style: italic; background-color: beige; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum claritatem. Investigationes demonstraverunt lectores legere me lius quod ii legunt saepius. Claritas est etiam processus dynamicus, qui sequitur mutationem consuetudium lectorum. Mirum est notare quam littera gothica, quam nunc putamus parum claram, anteposuerit litterarum formas humanitatis per seacula quarta decima et quinta decima . Eodem modo typi, qui nunc nobis videntur parum clari, fiant sollemnes in futurum. </td> </tr> <tr> <td style="background-color: silver; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">5</td> <td style="background-color: whitesmoke; font-weight: normal; font-style: normal; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. </td> </tr> <tr> <td style="background-color: lightgray; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">46</td> <td style="font-weight: bold; font-style: normal; background-color: oldlace; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum claritatem. Investigationes demonstraverunt lectores legere me lius quod ii legunt saepius. Claritas est etiam processus dynamicus, qui sequitur mutationem consuetudium lectorum. Mirum est notare quam littera gothica, quam nunc putamus parum claram, anteposuerit litterarum formas humanitatis per seacula quarta decima et quinta decima. Eodem modo typi, qui nunc nobis videntur parum clari, fiant sollemnes in futurum. </td> </tr> <tr> <td style="background-color: gainsboro; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">47</td> <td style="font-weight: normal; font-style: italic; background-color: azure; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. </td> </tr> <tr> <td style="background-color: whitesmoke; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">48</td> <td style="font-weight: bold; font-style: italic; background-color: beige; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum claritatem. Investigationes demonstraverunt lectores legere me lius quod ii legunt saepius. Claritas est etiam processus dynamicus, qui sequitur mutationem consuetudium lectorum. Mirum est notare quam littera gothica, quam nunc putamus parum claram, anteposuerit litterarum formas humanitatis per seacula quarta decima et quinta decima . Eodem modo typi, qui nunc nobis videntur parum clari, fiant sollemnes in futurum. </td> </tr> <tr> <td style="background-color: silver; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">49</td> <td style="background-color: whitesmoke; font-weight: normal; font-style: normal; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. </td> </tr> <tr> <td style="background-color: lightgray; font-weight: bold; font-size: 24px; width: 50px; text-align: center; vertical-align: middle">50</td> <td style="font-weight: bold; font-style: normal; background-color: oldlace; padding: 30px 10px 30px 10px">Page break inside this element will be avoided using the <b>'AvoidHtmlElementsBreakSelectors'</b> API property.<br /> <br /> Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Typi non habent claritatem insitam; est usus legentis in iis qui facit eorum claritatem. Investigationes demonstraverunt lectores legere me lius quod ii legunt saepius. Claritas est etiam processus dynamicus, qui sequitur mutationem consuetudium lectorum. Mirum est notare quam littera gothica, quam nunc putamus parum claram, anteposuerit litterarum formas humanitatis per seacula quarta decima et quinta decima. Eodem modo typi, qui nunc nobis videntur parum clari, fiant sollemnes in futurum. </td> </tr> <!-- The automaticaly repeated table footer --> <!-- To disable the repeating of the footer add style="display: table-row-group" to tfoot --> <tfoot> <tr> <td colspan="2"> <table style="border-top: 1px solid gray; width: 100%;"> <tr> <td style="font-size: 22px; font-weight: bold; color: green">Repeated Table Footer </td> <td style="width: 200px"> <img alt="Logo Image" style="float: right; width: 200px" src="img/logo.jpg" /> </td> </tr> </table> </td> </tr> </tfoot> </table> </body> </html>