Avoid Page Breaks Inside HTML Elements Using API

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#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Http;

// Use Winnovative Namespace
using Winnovative;

namespace WnvHtmlToPdfDemo.Controllers.HTML_to_PDF.Page_Breaks
{
    public class Avoid_Page_Breaks_Inside_HTML_Elements_Using_APIController : Controller
    {
        [HttpPost]
        public ActionResult ConvertHtmlToPdf(IFormCollection collection)
        {
            // Create a HTML to PDF converter object with default settings
            HtmlToPdfConverter htmlToPdfConverter = new HtmlToPdfConverter();

            // 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 = "fvDh8eDx4fHg4P/h8eLg/+Dj/+jo6Og=";

            // 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[] { collection["htmlElementsSelectorTextBox"] };

            byte[] outPdfBuffer = null;

            if (collection["HtmlPageSource"] == "convertHtmlRadioButton")
            {
                string htmlWithForm = collection["htmlStringTextBox"];
                string baseUrl = collection["baseUrlTextBox"];

                // Convert the HTML string to a PDF document in a memory buffer
                outPdfBuffer = htmlToPdfConverter.ConvertHtml(htmlWithForm, baseUrl);
            }
            else
            {
                string url = collection["urlTextBox"];

                // Convert the HTML page to a PDF document in a memory buffer
                outPdfBuffer = htmlToPdfConverter.ConvertUrl(url);
            }

            // Send the PDF file to browser
            FileResult fileResult = new FileContentResult(outPdfBuffer, "application/pdf");
            fileResult.FileDownloadName = "Avoid_Page_Breaks_Inside_HTML_Elements_Using_API.pdf";

            return fileResult;
        }
    }
}

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>