JS & DOM Reference
OverviewJavaScript Objects
JS Array JS Boolean JS Date JS Math JS Number JS String JS RegExp JS GlobalBrowser Objects
Window Navigator Screen History LocationCore DOM Objects
DOM Node DOM NodeList DOM NamedNodeMap DOM Document DOM Element DOM AttrHTML DOM Objects
DOM Document DOM Events DOM ElementsDOM Anchor DOM Area DOM Base DOM Body DOM Button DOM Form DOM Frame/IFrame DOM Frameset DOM Image DOM Input Button DOM Input Checkbox DOM Input File DOM Input Hidden DOM Input Password DOM Input Radio DOM Input Reset DOM Input Submit DOM Input Text DOM Link DOM Meta DOM Object DOM Option DOM Select DOM Style DOM Table DOM td / th DOM tr DOM Textarea
Style pageBreakBefore Property
Style Object
Definition and Usage
The pageBreakBefore property sets or returns the page-break behavior before an element (for printing or print preview).
Note: The pageBreakBefore property has no effect on absolutely positioned elements.
Syntax
Set the pageBreakBefore property:
Object.style.pageBreakBefore="auto|always|avoid|emptystring|left|right|inherit"
Return the pageBreakBefore property:
Object.style.pageBreakBefore
| Value | Description |
|---|---|
| auto | Insert a page break before the element if necessary. This is default |
| always | Always insert a page break before the element |
| avoid | Avoid a page break before the element |
| "" (empty string) | Page break is not inserted before the element |
| left | Insert one or two page breaks before the element, so the next page is considered a left page |
| right | Insert one or two page breaks before the element, so the next page is considered a right page |
| inherit | The value of the pageBreakBefore property is inherited from parent element |
Browser Support
The pageBreakBefore property is supported in all major browsers.
Note: The value "inherit" is not supported in IE7 and earlier. IE8 requires a !DOCTYPE. IE9 supports "inherit".
Example
Example
Always set a page break before each <p> element with id="footer":
<html>
<head>
<script>
function setPageBreak()
{
document.getElementById("footer").style.pageBreakBefore="always";
}
</script>
</head>
<body>
<h1>This is a heading</h1>
<p>This is a paragraph.</p>
<p id="footer">This is a footer paragraph.</p>
<button type="button" onclick="setPageBreak()">Set page-break before footer paragraph</button>
<p>Click the button above and see the changes in print or print preview.</p>
</body>
</html>
<head>
<script>
function setPageBreak()
{
document.getElementById("footer").style.pageBreakBefore="always";
}
</script>
</head>
<body>
<h1>This is a heading</h1>
<p>This is a paragraph.</p>
<p id="footer">This is a footer paragraph.</p>
<button type="button" onclick="setPageBreak()">Set page-break before footer paragraph</button>
<p>Click the button above and see the changes in print or print preview.</p>
</body>
</html>
Try it yourself »
Style Object
Your suggestion:
Close [X]
Thank You For Helping Us!
Your message has been sent to W3Schools.
Close [X]
