HTML - DOM Style Object pageBreakBefore Property

Quiz

HTML DOM Style Object pageBreakBefore property sets or returns the page break behavior before an element during print or print preview.

Syntax

Set the pageBreakBefore property:

object.style.pageBreakBefore= "auto | always | avoid | emptystring | left | right | initial | inherit";

Get the pageBreakBefore property:

object.style.pageBreakBefore;

Property Values

Value	Description
auto	It is the default value which inserts a page break before the element if required.
always	It always inserts page break before the element.
avoid	It avoids the page break before the element.
emptystring	It does not insert page break before the element.
left	It inserts one or two page breaks before the element, so that the next page is to be considered as left page.
right	It inserts one or two page breaks before the element, so that the next page is to be considered as right page.
initial	It is used to set this property to it's default value.
inherit	It is used to inherit the property of it's parent element.

Return Value

It returns a string value which represents page break behavior before an element while printing.

Example of HTML DOM Style Object 'pageBreakBefore' Property

The following example sets page break before property where it specifies before which element page will break during print or print preview.

<!DOCTYPE html>
<html>
<head>
    <title>
        HTML DOM Style Object pageBreakBefore Property
    </title>
</head>
<body>    
    <h3>
        You need to save this code in 
        your system to see changes
    </h3>
    <p>
        Click to see effects in print 
        or print preview option.
    </p>
    <button onclick="fun()">Click</button>
    <p>Welcome to Tutorials Point.</p>
    <p id="result">
        Page break before this paragraph.
    </p>
    <p>
        This paragraph will appear in new page
    </p>    
    <script>
        function fun() {
            document.getElementById("result")
                .style.pageBreakBefore = "always";
        }
    </script>
</body>
</html>

Supported Browsers

Property
pageBreakBefore	Yes 1	Yes 12	Yes 1	Yes 1.2	Yes 7

html_dom.htm

Print Page