page-break-before (CSS property)
| Inherited | Initial | Version |
|---|---|---|
| No | auto |
CSS2 |
| IE5.5+ | FF1+ | SA1.3+ | OP9.2+ |
|---|---|---|---|
| Partial | Partial | Partial | Full |
Syntax
Description
This property specifies whether a page break may, must, or shouldn’t occur before a block-level element’s generated box.
Example
This style rule makes every
h2 element start at the top of a new
page:
h2 {
page-break-before: always;
}
Value
always- forces a page break before the box
auto- allows a page break before the box, but doesn’t require it
avoid- tells the user agent to avoid inserting a page break before the box, if at all possible
left- forces one or two page breaks before the box, so that the next page will be a left-hand page
right- forces one or two page breaks before the box, so that the next page will be a right-hand page
Compatibility
| Internet Explorer | Firefox | Safari | Opera | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 5.5 | 6.0 | 7.0 | 1.0 | 1.5 | 2.0 | 1.3 | 2.0 | 3.0 | 9.2 | 9.5 |
| Partial | Partial | Partial | Partial | Partial | Partial | Partial | Partial | Partial | Full | Full |
Internet Explorer for Windows versions up to and
including 7 do not support the values left and
right; either value is interpreted as the value
always.
Internet Explorer for Windows versions up to and
including 7 don’t support the value inherit.
Firefox versions up to and including 2 don’t
support the avoid, left, or
right values.
Safari
versions up to and including 3 don’t support the
avoid, left, or
right values.
User-contributed notes
There are no comments yet.
Add a note
To post a note on this topic, please log in with your SitePoint username and password. If you don't have an account yet, you can create a new account for free.