W3C home > Mailing lists > Public > public-css-commits@w3.org > January 2012

csswg/css3-break Overview.html,1.8,1.9 Overview.src.html,1.9,1.10

From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 24 Jan 2012 23:14:55 +0000
To: public-css-commits@w3.org
Message-Id: <E1RppZn-0007sH-57@lionel-hutz.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&mdash;such as a page, column, or region&mdash;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
+   &lsquo;<code class=property>box-decoration-break</code>&rsquo; 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 &lsquo;<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&mdash;such as a page, column, or region&mdash;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

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:44:49 UTC