- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 24 Jan 2012 23:14:55 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-break
In directory hutz:/tmp/cvs-serv30255
Modified Files:
Overview.html Overview.src.html
Log Message:
Define model/terminology
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-break/Overview.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- Overview.html 24 Jan 2012 22:04:04 -0000 1.8
+++ Overview.html 24 Jan 2012 23:14:53 -0000 1.9
@@ -141,10 +141,6 @@
<li><a href="#fragmentation-model"><span class=secno>2. </span>
Fragmentation Model and Terminology</a>
- <ul class=toc>
- <li><a href="#page-breaks"><span class=secno>2.1. </span> Page
- Breaks</a>
- </ul>
<li><a href="#breaking-controls"><span class=secno>3. </span> Breaking
Controls</a>
@@ -270,23 +266,70 @@
<h2 id=fragmentation-model><span class=secno>2. </span> Fragmentation Model
and Terminology</h2>
- <h3 id=page-breaks><span class=secno>2.1. </span> Page Breaks</h3>
+ <dl>
+ <dt><dfn id=fragmented-flow>fragmented flow</dfn>
- <p> The following sections explain page breaking in CSS3 paged media. Five
- properties indicate where the user agent may or should break pages, and on
- what page (left or right) the subsequent content should resume. Each page
- break ends layout in the current <a href="#page-box">page box</a> and
- causes remaining pieces of the document tree to be laid out in a new page
- box.
+ <dd> A content flow that is being laid out in a <a
+ href="#fragmentation-context"><i>fragmentation context</i></a>, such as a
+ <a href="http://www.w3.org/TR/css3-multicol/">multi-column element</a>, a
+ chain of <a href="http://www.w3.org/TR/css3-regions">CSS regions</a>, or
+ a <a href="http://www.w3.org/TR/css3-page/">paged media display</a>.
- <p> When a page break splits a box, the box's bottom margins, borders, and
- padding have no visual effect where the split occurs; the box's background
- and left and right margins, border, and padding extend to the bottom of
- the page, through an ensuing blank page if one exists, and onto the top of
- the subsequent page.
+ <dt><dfn id=fragmentation-container>fragmentation container</dfn>
+
+ <dd> A box—such as a page, column, or region—that contains a
+ portion (or all) of a <a href="#fragmented-flow"><i>fragmented
+ flow</i></a>. Fragmentation containers can be pre-defined, or generated
+ as needed. When breakable content overflows a fragmentation container in
+ the block dimension, instead of overflowing it breaks into the next
+ container in its <a href="#fragmentation-context"><i>fragmentation
+ context</i></a>.
+
+ <dt><dfn id=fragmentation-context>fragmentation context</dfn>
+
+ <dd> An ordered series of <i>fragmentation containers</i>. A given
+ fragmentation context can only have one block flow direction across all
+ its fragmentation containers.
+
+ <dt><dfn id=fragmentation0>fragmentation</dfn>
+
+ <dd> The process of splitting a content flow across the <i>fragmentation
+ containers</i> that form a <a
+ href="#fragmentation-context"><i>fragmentation context</i></a>.
+
+ <dt><dfn id=box-fragment>box fragment</dfn> or <dfn
+ id=fragment>fragment</dfn>
+
+ <dd> The portion of a box that belongs to exactly one <a
+ href="#fragmentation-container"><i>fragmentation container</i></a>. A box
+ in continuous flow always consists of only one fragment. A box in a
+ fragmented flow consists of one or more fragments.
+ </dl>
+
+ <p> Each <dfn id=fragmentation-break>fragmentation break</dfn> (hereafter,
+ <dfn id=break>break</dfn>) ends layout in the current <a
+ href="#fragmentation-container"><i>fragmentation container</i></a> and
+ causes the remaining content of the fragmented flow to be laid out in the
+ next <a href="#fragmentation-container"><i>fragmentation
+ container</i></a>.
+
+ <p class=note> Breaking inline content into lines is another form of
+ fragmentation, and similarly creates box fragments when it breaks <a
+ href="http://www.w3.org/TR/CSS21/visuren.html#inline-boxes">inline
+ boxes</a>. However, inline breaking is not covered here; see <a
+ href="#CSS3TEXT" rel=biblioentry>[CSS3TEXT]<!--{{CSS3TEXT}}--></a> and the
+ ‘<code class=property>box-decoration-break</code>’ property in
+ [[CSS3BACKGROUND]].
<h2 id=breaking-controls><span class=secno>3. </span> Breaking Controls</h2>
+ <p> The following sections explain how breaks are controlled in a
+ fragmented flow. Five properties indicate where the user agent may or
+ should break the content flow. In the case of pagination, the author can
+ also specify on which page (<a
+ href="http://www.w3.org/TR/css3-page/#left-right-first">left or right</a>)
+ the subsequent content should resume.
+
<h3 id=pg-br-before-after><span class=secno>3.1. </span> Breaking
before/after/inside elements: the ‘<a
href="#page-break-before"><code
@@ -703,6 +746,12 @@
<h2 id=breaking-rules><span class=secno>4. </span> Rules for Breaking</h2>
+ <p> When a break splits a box, the box's bottom margins, borders, and
+ padding have no visual effect where the split occurs; the box's background
+ and left and right margins, border, and padding extend to the bottom of
+ the page, through an ensuing blank page if one exists, and onto the top of
+ the subsequent page.
+
<h3 id=allowed-pg-brk><span class=secno>4.1. </span> Allowed page breaks</h3>
<p>In the normal flow, page breaks may occur at the following places:
@@ -1112,6 +1161,16 @@
href="http://www.w3.org/TR/2006/WD-css3-page-20061010">http://www.w3.org/TR/2006/WD-css3-page-20061010</a>
</dd>
<!---->
+
+ <dt id=CSS3TEXT>[CSS3TEXT]
+
+ <dd>Elika J. Etemad; Koji Ishii; Shinyu Murakami. <a
+ href="http://www.w3.org/TR/2011/WD-css3-text-20110901/"><cite>CSS Text
+ Level 3.</cite></a> 1 September 2011. W3C Working Draft. (Work in
+ progress.) URL: <a
+ href="http://www.w3.org/TR/2011/WD-css3-text-20110901/">http://www.w3.org/TR/2011/WD-css3-text-20110901/</a>
+ </dd>
+ <!---->
</dl>
<!--end-informative-->
@@ -1122,8 +1181,28 @@
<li>authoring tool, <a href="#authoring-tool"
title="authoring tool"><strong>5.2.</strong></a>
+ <li>box fragment, <a href="#box-fragment"
+ title="box fragment"><strong>2.</strong></a>
+
+ <li>break, <a href="#break" title=break><strong>2.</strong></a>
+
+ <li>fragment, <a href="#fragment" title=fragment><strong>2.</strong></a>
+
<li>fragmentation, <a href="#fragmentation"
- title=fragmentation><strong>1.</strong></a>
+ title=fragmentation><strong>1.</strong></a>, <a href="#fragmentation0"
+ title=fragmentation><strong>2.</strong></a>
+
+ <li>fragmentation break, <a href="#fragmentation-break"
+ title="fragmentation break"><strong>2.</strong></a>
+
+ <li>fragmentation container, <a href="#fragmentation-container"
+ title="fragmentation container"><strong>2.</strong></a>
+
+ <li>fragmentation context, <a href="#fragmentation-context"
+ title="fragmentation context"><strong>2.</strong></a>
+
+ <li>fragmented flow, <a href="#fragmented-flow"
+ title="fragmented flow"><strong>2.</strong></a>
<li>orphans, <a href="#orphans" title=orphans><strong>3.2.</strong></a>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-break/Overview.src.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Overview.src.html 24 Jan 2012 22:04:04 -0000 1.9
+++ Overview.src.html 24 Jan 2012 23:14:53 -0000 1.10
@@ -114,28 +114,68 @@
<h2 id="fragmentation-model">
Fragmentation Model and Terminology</h2>
-
-<h3 id="page-breaks">
-Page Breaks</h3>
+ <dl>
+ <dt><dfn>fragmented flow</dfn></dt>
+ <dd>
+ A content flow that is being laid out in a <i>fragmentation context</i>,
+ such as a <a href="http://www.w3.org/TR/css3-multicol/">multi-column element</a>,
+ a chain of <a href="http://www.w3.org/TR/css3-regions">CSS regions</a>,
+ or a <a href="http://www.w3.org/TR/css3-page/">paged media display</a>.
+ </dd>
+ <dt><dfn>fragmentation container</dfn></dt>
+ <dd>
+ A box—such as a page, column, or region—that contains a portion
+ (or all) of a <i>fragmented flow</i>.
+ Fragmentation containers can be pre-defined, or generated as needed.
+ When breakable content overflows a fragmentation container in the block
+ dimension, instead of overflowing it breaks into the next container
+ in its <i>fragmentation context</i>.
+ </dd>
+ <dt><dfn>fragmentation context</dfn></dt>
+ <dd>
+ An ordered series of <i>fragmentation containers</i>.
+ A given fragmentation context can only have one block flow direction
+ across all its fragmentation containers.
+ </dd>
+ <dt><dfn>fragmentation</dfn></dt>
+ <dd>
+ The process of splitting a content flow across the <i>fragmentation
+ containers</i> that form a <i>fragmentation context</i>.
+ </dd>
+ <dt><dfn>box fragment</dfn> or <dfn>fragment</dfn></dt>
+ <dd>
+ The portion of a box that belongs to exactly one <i>fragmentation
+ container</i>. A box in continuous flow always consists of only one
+ fragment. A box in a fragmented flow consists of one or more fragments.
+ </dl>
<p>
- The following sections explain page breaking in CSS3 paged media. Five properties
- indicate where the user agent may or should break pages, and on what page
- (left or right) the subsequent content should resume. Each page break ends
- layout in the current <a href="#page-box">page
- box</a> and causes remaining pieces of the document tree to be laid out
- in a new page box.
+ Each <dfn>fragmentation break</dfn> (hereafter, <dfn>break</dfn>) ends
+ layout in the current <i>fragmentation container</i> and causes the
+ remaining content of the fragmented flow to be laid out in the next
+ <i>fragmentation container</i>.
</p>
- <p>
- When a page break splits a box, the box's bottom margins, borders, and padding have
- no visual effect where the split occurs; the box's background and left and right
- margins, border, and padding extend to the bottom of the page, through an ensuing
- blank page if one exists, and onto the top of the subsequent page.
+
+ <p class="note">
+ Breaking inline content into lines is another form of fragmentation,
+ and similarly creates box fragments when it breaks
+ <a href="http://www.w3.org/TR/CSS21/visuren.html#inline-boxes">inline boxes</a>.
+ However, inline breaking is not covered here; see [[CSS3TEXT]] and
+ the 'box-decoration-break' property in [[CSS3BACKGROUND]].
</p>
<h2 id="breaking-controls">
Breaking Controls</h2>
+ <p>
+ The following sections explain how breaks are controlled in a fragmented
+ flow. Five properties indicate where the user agent may or should break
+ the content flow. In the case of pagination, the author can also specify
+ on which page (<a href="http://www.w3.org/TR/css3-page/#left-right-first">left or right</a>)
+ 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>
@@ -451,6 +491,13 @@
<h2 id="breaking-rules">
Rules for Breaking</h2>
+ <p>
+ When a break splits a box, the box's bottom margins, borders, and padding have
+ no visual effect where the split occurs; the box's background and left and right
+ margins, border, and padding extend to the bottom of the page, through an ensuing
+ blank page if one exists, and onto the top of the subsequent page.
+ </p>
+
<h3 id="allowed-pg-brk">
Allowed page breaks</h3>
Received on Tuesday, 24 January 2012 23:14:57 UTC