- From: Rossen Atanassov via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 25 Jan 2012 01:38:02 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-break In directory hutz:/tmp/cvs-serv8771 Modified Files: Overview.html Overview.src.html Log Message: Adding specification for secions 3. Breaking Control, 3.1 Breaking before/after/inside and 3.2 Orphans and Widows Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-break/Overview.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -d -r1.10 -r1.11 --- Overview.html 24 Jan 2012 23:25:14 -0000 1.10 +++ Overview.html 25 Jan 2012 01:38:00 -0000 1.11 @@ -12,19 +12,19 @@ <body> <div class=head> <!--begin-logo--> - <p><a href="http://www.w3.org/"><img alt=W3C height=48 + <p id=x><a href="http://www.w3.org/"><img alt=W3C height=48 src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo--> <h1 id=css-fragmentation-module>CSS Fragmentation Controls Module Level 3</h1> - <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 24 January + <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 25 January [...1387 lines suppressed...] <td>auto - <td>block-level boxes, table row groups, table rows, and table cells - (but see prose) + <td>block-level elements - <td>no + <td>no (but see prose) <td>N/A @@ -1335,7 +1421,7 @@ <td>2 - <td>block-level elements + <td>block containers <td>yes Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-break/Overview.src.html,v retrieving revision 1.11 retrieving revision 1.12 diff -u -d -r1.11 -r1.12 --- Overview.src.html 24 Jan 2012 23:25:14 -0000 1.11 +++ Overview.src.html 25 Jan 2012 01:38:00 -0000 1.12 @@ -175,136 +175,181 @@ the subsequent content should resume. </p> - -<h3 id="pg-br-before-after"> -Breaking before/after/inside elements: the 'page-break-before', 'page-break-after', and 'page-break-inside' properties - </h3> +<h3 id="explicit-break-properties"> +Breaking before, after or inside elements: the 'break-before', 'break-after', 'break-inside' +properties.</h3> <table class="propdef" summary="property definition"> <tr> - <th>Name: - <td><dfn id="page-break-before">page-break-before</dfn> + <td><em>Name:</em> + <td><dfn>break-before</dfn> <tr> - <th>Value: - <td>auto | always | avoid | left | right + <td><em>Value:</em> + <td>auto | always | left | right | page | column | region | avoid | avoid-page | avoid-column | avoid-region <tr> - <th>Initial: + <td><em>Initial:</em> <td>auto <tr> - <th>Applies to: - <td>block-level elements + <td><em>Applies to:</em> + <td>block-level elements, table row groups, table rows (but see prose) <tr> - <th>Inherited: + <td><em>Inherited:</em> <td>no <tr> - <th>Percentages: + <td><em>Percentages:</em> <td>N/A <tr> - <th>Media: + <td><em>Media:</em> <td>paged <tr> - <th>Computed value: + <td><em>Computed value:</em> <td>specified value </table> <table class="propdef" summary="property definition"> <tr> - <th>Name: - <td><dfn id="page-break-after">page-break-after</dfn> + <td><em>Name:</em> + <td><dfn>break-after</dfn> <tr> - <th>Value: - <td>auto | always | avoid | left | right + <td><em>Value:</em> + <td>auto | always | left | right | page | column | region | avoid | avoid-page | avoid-column | avoid-region <tr> - <th>Initial: + <td><em>Initial:</em> <td>auto <tr> - <th>Applies to: - <td>block-level boxes, table row groups, table rows (but see prose) + <td><em>Applies to:</em> + <td>block-level elements, table row groups, table rows (but see prose) <tr> - <th>Inherited: + <td><em>Inherited:</em> <td>no <tr> - <th>Percentages: + <td><em>Percentages:</em> <td>N/A <tr> - <th>Media: + <td><em>Media:</em> <td>paged <tr> - <th>Computed value: + <td><em>Computed value:</em> <td>specified value </table> <table class="propdef" summary="property definition"> <tr> - <th>Name: - <td><dfn id="page-break-inside">page-break-inside</dfn> + <td><em>Name:</em> + <td><dfn>break-inside</dfn> <tr> - <th>Value: - <td>auto | avoid + <td><em>Value:</em> + <td>auto | avoid | avoid-page | avoid-column | avoid-region <tr> - <th>Initial: + <td><em>Initial:</em> <td>auto <tr> - <th>Applies to: - <td>block-level boxes, table row groups, table rows, and table cells - (but see prose) + <td><em>Applies to:</em> + <td>block-level elements, block containers, table row groups, table rows (but see prose) <tr> - <th>Inherited: + <td><em>Inherited:</em> <td>no <tr> - <th>Percentages: + <td><em>Percentages:</em> <td>N/A <tr> - <th>Media: + <td><em>Media:</em> <td>paged <tr> - <th>Computed value: + <td><em>Computed value:</em> <td>specified value </table> - <p>Values for these properties have the following meanings:</p> - + <p> + These properties describe page/column/region break behavior before/after/inside the generated + box. These values have the following meaning: + </p> + <dl> - <dt>auto</dt> + <dt> + auto + </dt> <dd> - Neither force nor forbid a page break before / after / inside the - generated box. + Neither force nor forbid a break before/after/inside the principle box. + </dd> + <dt> + always + </dt> + <dd> + Always force a break before/after the principle box. </dd> - <dt>always</dt> + <dt> + avoid + </dt> <dd> - Always force a page break before / after the generated box. + Avoid a break before/after/inside the principle box. + </dd> + <dt> + left + </dt> + <dd> + Force one or two page breaks before/after the principle box so that the next page is formatted as a left page. </dd> - <dt>avoid</dt> + <dt> + right + </dt> <dd> - Avoid a page break before / after / inside the generated box. + Force one or two page breaks before/after the principle box so that the next page is formatted as a right page. </dd> - <dt>left</dt> + <dt> + page + </dt> <dd> - Force one or two page breaks before (after) the generated box so that - the next page is formatted as a left page. + Always force a page break before/after the principle box. </dd> - <dt>right</dt> + <dt> + column + </dt> <dd> - Force one or two page breaks before (after) the generated box so that - the next page is formatted as a right page. + Always force a column break before/after the principle box. + </dd> + <dt> + region + </dt> + <dd> + Always force a region break before/after the principle box. + </dd> + <dt> + avoid-page + </dt> + <dd> + Avoid a page break before/after/inside the principle box. + </dd> + <dt> + avoid-column + </dt> + <dd> + Avoid a column break before/after/inside the principle box. + </dd> + <dt> + avoid-region + </dt> + <dd> + Avoid a region break before/after/inside the principle box. </dd> </dl> + <p> - A potential page break location is typically under the influence - of the parent element's 'page-break-inside' property, the - 'page-break-after' property of the preceding element, and the - 'page-break-before' property of the following element. When these - properties have values other than ''auto'', the values ''always'', - ''left'', and ''right'' take precedence over 'avoid'. See the section - on <a href="#allowed-pg-brk">allowed page breaks</a> for the exact rules - on how these properties affect page breaks. + A potential page/column/region break location is typically under the influence of + the parent element's 'break-inside' property, the 'break-after' property of the + preceding element, and the 'break-before' property of the following element. When + these properties have values other than ''auto'', the forced break values (''always'', + ''left'', ''right'', ''page'', ''column'' and ''region'') take precedence over the + values (''avoid-page'', ''avoid-column'' and ''avoid-region''). See the section + on <a href="#breaking-rules">rules for breaking</a> for the exact rules on how these + properties affect forced breaks. </p> <p> User Agents must apply these properties to block-level boxes and to table rows, - table row groups, and—in the case of 'page-break-inside'—table cells - of block-level tables in the normal flow of the root element. User agents should - also apply these properties to floated boxes whose containing block is in the normal - flow of the root element. User agents may also apply these properties to other boxes. + table row groups, and—in the case of 'break-inside'—block containers + in the normal flow of the root element. User agents should also apply these properties + to floated boxes whose containing block is in the normal flow of the root element. + User agents may also apply these properties to other boxes. </p> <h3 id="breaks-inside"> @@ -325,7 +370,7 @@ <tr> <th>Applies to: - <td>block-level elements + <td>block containers <tr> <th>Inherited: @@ -360,7 +405,7 @@ <tr> <th>Applies to: - <td>block-level elements + <td>block containers <tr> <th>Inherited: @@ -381,11 +426,12 @@ </table> <p> - The 'orphans' property specifies the minimum number of line boxes in - a block element that must be left at the bottom of a page. The 'widows' - property specifies the minimum number of line boxes of a block element - that must be left at the top of a page. Examples of how they are used to - control page breaks are given below. + The 'orphans' property specifies the minimum number of line boxes in a block container + that must be left at the end of a <i>fragment</i>, unless this is the last <i>fragment</i> + of the box. The 'widows' property specifies the minimum number of line boxes of + a block container that must be left at the start of a <i>fragment</i>, unless this + is the last <i>fragment</i> of the box. Examples of how they are used to control + <i>fragmenter</i> breaks are given below. </p> <p> Only positive integers are allowed as values of 'orphans' and 'widows'. Negative
Received on Wednesday, 25 January 2012 01:38:09 UTC