page-break-before

page-break-before CSS属性调整当前元素之前的分页符。

此属性适用于生成一个盒子的块元素。它不适用于不会生成一个盒子的空 <div>。

/* Keyword values */
page-break-before: auto;
page-break-before: always;
page-break-before: avoid;
page-break-before: left;
page-break-before: right;
page-break-before: recto;
page-break-before: verso;

/* Global values */
page-break-before: inherit;
page-break-before: initial;
page-break-before: unset;

Note: this property is in progress of being replaced by the more generic break-before. This new property also handles column and region breaks and is syntactically compatible with page-break-before.

Before using page-break-before, check if you can use break-before instead. In the future page-break-before will be a mere alias for some values of it.

初始值	`auto`
适用元素	block-level elements in the normal flow of the root element. User agents may also apply it to other elements like `table-row` elements.
是否是继承属性	否
适用媒体	as each of the properties of the shorthand: `visual`: Value not found in DB! `paged`: Value not found in DB!
计算值	as specified
Animation type	discrete
正规顺序	the unique non-ambiguous order defined by the formal grammar

Syntax

Values

auto: Initial value. Automatic page breaks (neither forced nor forbidden).
always: Always force page breaks before the element.
avoid: Avoid page breaks before the element.
left: Force page breaks before the element so that the next page is formatted as a left page.
right: Force page breaks before the element so that the next page is formatted as a right page.
recto: If pages progress left-to-right, then this acts like right. If pages progress right-to-left, then this acts like left.
verso: If pages progress left-to-right, then this acts like left. If pages progress right-to-left, then this acts like right.

Formal syntax

auto | always | avoid | left | right | recto | verso

Examples

/* avoid page break before the div */
div.note { 
    page-break-before: avoid;
}

Specification

Specification	Status	Comment
CSS Logical Properties and Values Level 1 recto and verso	Editor's Draft	Adds the values `recto` and `verso`.
CSS Paged Media Module Level 3 page-break-before	Working Draft	Extends the element that this property applies to table rows and table row groups.
CSS Level 2 (Revision 1) page-break-before	Recommendation	Initial definition

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`page-break-before`	Chrome Full support 1	Edge Full support 12	Firefox Full support 1 Notes Full support 1 Notes Notes The values `avoid`, `left`, and `right` are unsupported.	IE Full support 4	Opera Full support 7	Safari Full support 1.2	WebView Android Full support 37	Chrome Android Full support 18	Firefox Android Full support 4 Notes Full support 4 Notes Notes The values `avoid`, `left`, and `right` are unsupported.	Opera Android ?	Safari iOS Full support 1	Samsung Internet Android Full support 1.0

Legend

Full support: Full support
Compatibility unknown: Compatibility unknown
See implementation notes.: See implementation notes.