page-break-after Attribute | pageBreakAfter Property

Sets or retrieves a value indicating whether a page break occurs after the object .

Syntax

HTML Scripting

{ page-break-after : sBreak }

object . style.pageBreakAfter [ = sBreak ]

Possible Values

sBreak

String that specifies or receives one of the following values.

always	Always insert a page break after the object.
auto	Default. Neither force nor forbid a page break after the object.
empty string	Do not insert a page break.
left	Currently works the same as always .
right	Currently works the same as always .

The property is read/write for all objects except the following, for which it is read-only: currentStyle . The property has 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 About Dynamic Properties .

Remarks

This property applies when printing the document. This property does not apply to the BR or HR elements.

If there are conflicts between this property and the pageBreakBefore value on the 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.

Examples

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

This example uses the p element as a selector in an embedded style sheet to break the page at the end of all paragraphs.

<STYLE> P { page-break-after : always } </STYLE> </HEAD> <BODY> <P> : </P>

This example uses a call to a function to turn off the page break after the object that has an ID value of idParagraph .

<SCRIPT> function offBreak() { idParagraph.style. pageBreakAfter =""; } </SCRIPT>
</HEAD>
<BODY> <BUTTON onClick="offBreak()">Turn Off Break</BUTTON>

Standards Information

This property is defined in Cascading Style Sheets (CSS), Level 2 (CSS2) .

Applies To

[ Object Name ] Platform Version

Win16:
Win32:
Windows CE:
Unix:
Mac:

BLOCKQUOTE , BODY , BUTTON , CAPTION , CENTER , currentStyle , DD , DIR , DIV , DL , DT , FIELDSET , FORM , hn , ISINDEX , LI , LISTING , MARQUEE , MENU , OL , P , PLAINTEXT , PRE , runtimeStyle , style , TABLE , TBODY , TFOOT , TH , THEAD , TR , UL , XMP

Home | Top | Web development | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→