这篇翻译不完整。请帮忙从英语翻译这篇文章。
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: |
计算值 | 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 likeleft
. verso
- If pages progress left-to-right, then this acts like
left
. If pages progress right-to-left, then this acts likeright
.
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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Basic support | Chrome Full support 1 | Edge Full support 12 | Firefox
Full support
1
| IE Full support 4 | Opera Full support 7 | Safari Full support 1.2 | WebView Android ? | Chrome Android ? | Edge Mobile Full support Yes | Firefox Android
Full support
4
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- See implementation notes.
- See implementation notes.