Click to return to the DHTML, HTML     
page-break-after Attribut...     palette Property     DHTML Properties    
Web Workshop  |  DHTML, HTML & CSS

page-break-before Attribute | pageBreakBefore Property


Sets or retrieves whether a page break occurs before the object.

Syntax

HTML{ page-break-before: sBreak }
Scriptingobject.style.pageBreakBefore [ = sBreak ]

Possible Values

sBreak String that specifies one of the following values:
alwaysAlways insert a page break before the object.
autoNeither force nor forbid a page break before the object.
""Empty string does not insert a page break.

The property is read/write with a default value of auto; the cascading style sheets (CSS) attribute is not inherited.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see Dynamic Properties.

Remarks

This property applies when printing the document.

If there are conflicts between this property and the pageBreakAfter value object previously displayed in the browser, the value that results in the largest number of page breaks is used.

Page breaks are not permitted inside positioned objects.

Example

The following examples use the page-break-before attribute and the pageBreakBefore property to start printing on a new page.

This example uses the H3 element as a selector in an embedded style sheet to break the page before all H3 headings.

Sample Code

<STYLE>
    H3 { page-break-before: always }
</STYLE>
</HEAD>
<BODY>
<H3>Start New Section on New Page</H3>

This feature requires Internet Explorer 4.0 or later. Click the icon below to install the latest version. Then reload this page to view the sample.
Microsoft Internet Explorer

This example uses a call to a function to turn off the page break before the object that has an id value of idParagraph. When the page is printed, a page break occurs before the first paragraph unless the user clicks the Turn Off Break button.

<SCRIPT>
function offBreak()
{
    idParagraph.style.pageBreakBefore="";
}
</SCRIPT>
</HEAD>
<BODY>
<BUTTON onClick="offBreak()">Turn off break</BUTTON> 
<P ID="Paragraph" STYLE="page-break-before:always">
:
</P>

This feature requires Internet Explorer 4.0 or later. Click the icon below to install the latest version. Then reload this page to view the sample.
Microsoft Internet Explorer

Applies To

[ Object Name ]
PlatformVersion
Win16:
Win32:
Mac:
Unix:
WinCE:
BLOCKQUOTE, BODY, BUTTON, CENTER, currentStyle, DD, DIR, DIV, DL, DT, FIELDSET, FORM, Hn, ISINDEX, LI, LISTING, MARQUEE, MENU, OL, P, PLAINTEXT, PRE, runtimeStyle, style, TABLE, TD, TR, UL, XMP


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.