[css-sizing] Define 'preferred size'.

Author: tabatkins

css-sizing/Overview.html

@@ -12,7 +12,7 @@
   <meta content="CSS Intrinsic &amp; Extrinsic Sizing Module Level 3"
    name=dcterms.title>
   <meta content=text name=dcterms.type>
-  <meta content=2013-08-19 name=dcterms.date>
+  <meta content=2013-08-20 name=dcterms.date>
   <meta content="Tab Atkins Jr." name=dcterms.creator>
   <meta content="Elika J. Etemad" name=dcterms.creator>
   <meta content=W3C name=dcterms.publisher>
@@ -32,11 +32,11 @@
 
    <h1>CSS Intrinsic &amp; Extrinsic Sizing Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 19 August 2013</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 20 August 2013</h2>
 
    <dl><!--
 	<dt>This version:
-		<dd><a href="http://dev.w3.org/csswg/css3-sizing/">http://www.w3.org/TR/2013/ED-css3-sizing-20130819/</a>
+		<dd><a href="http://dev.w3.org/csswg/css3-sizing/">http://www.w3.org/TR/2013/ED-css3-sizing-20130820/</a>
 -->
 
     <dt>Latest version:
@@ -383,15 +383,22 @@ <h2 id=terms><span class=secno>2. </span> Terminology</h2>
    <dt><dfn id=fit-content-measure>fit-content measure</dfn>
 
    <dd> If the <a href="#available"><i>available</i></a> measure is finite,
-    equal to <code>min(<a href="#max-content"><i>max-content</i></a>, max(<a
-    href="#min-content"><i>min-content</i></a>,
-    <i>fill-available</i>))</code>. Otherwise, equal to the <a
+    equal to <code>min(<a href="#preferred-measure"><i>preferred
+    measure</i></a>, max(<a href="#min-content-measure"><i>min-content
+    measure</i></a>, <a href="#fill-available-measure"><i>fill-available
+    measure</i></a>))</code>. Otherwise, equal to the <a
     href="#max-content-measure"><i>max-content measure</i></a>.
     <p class=note> Note: This is called the <i>shrink-to-fit</i> width in <a
      href="http://www.w3.org/TR/CSS21/visudet.html#float-width">CSS2.1§10.3.5</a>
      and <a href="http://www.w3.org/TR/css3-multicol/#pseudo-algorithm">CSS
      Multi-column Layout § 3.4</a>.
 
+   <dt><dfn id=preferred-measure>preferred measure</dfn>
+
+   <dd> A box’s “ideal” <i>measure</i>. Unless otherwise specified,
+    this is the <a href="#max-content-measure"><i>max-content
+    measure</i></a>.
+
    <dt><dfn id=fill-available-extent>fill-available extent</dfn>
 
    <dd> Roughly, the <i>extent</i> a box would take if it filled its <a
@@ -406,16 +413,24 @@ <h2 id=terms><span class=secno>2. </span> Terminology</h2>
    <dt><dfn id=min-content-extent>min-content extent</dfn>
 
    <dd> Equivalent to the <a href="#max-content-extent"><i>max-content
-    extent</i></a>. <span class=issue>Or should this be the minimum between
-    allowed break points? It might make sense in multi-col contexts to have
-    min-content and max-content extents be different, even if they are the
-    same elsewhere.</span>
+    extent</i></a>.
+    <p class=issue> Or should this be the minimum between allowed break
+     points? It might make sense in multi-col contexts to have min-content
+     and max-content extents be different, even if they are the same
+     elsewhere.
 
    <dt><dfn id=fit-content-extent>fit-content extent</dfn>
 
    <dd> Analogous to the <a href="#fit-content-measure"><i>fit-content
     measure</i></a>.
 
+   <dt><dfn id=preferred-extent>preferred extent</dfn>
+
+   <dd> Equivalent to the <a href="#max-content-extent"><i>max-content
+    extent</i></a>.
+    <p class=issue> Same issue as <a
+     href="#min-content-extent"><i>min-content extent</i></a>.
+
    <dt><dfn id=max-size-contribution>max-size contribution</dfn>
 
    <dd> The size that a box contributes to its <i>containing
@@ -426,6 +441,13 @@ <h2 id=terms><span class=secno>2. </span> Terminology</h2>
    <dd> The size that a box contributes to its <i>containing block</i>’s
     <i>min-content size</i>.
 
+   <dt><dfn id=preferred-size-contribution>preferred-size contribution</dfn>
+
+   <dd> If the box's layout mode has a defined <a
+    href="#preferred-size-contribution"><i>preferred-size
+    contribution</i></a>, that. Otherwise, the box's <a
+    href="#max-size-contribution"><i>max-size contribution</i></a>.
+
    <dt><dfn id=max-size-constraint>max-size constraint</dfn>
 
    <dd> A sizing constraint imposed by the box's <i>containing block</i> that
@@ -437,6 +459,13 @@ <h2 id=terms><span class=secno>2. </span> Terminology</h2>
    <dd> A sizing constraint imposed by the box's <i>containing block</i> that
     causes it to produce its <a href="#min-size-contribution"><i>min-size
     contribution</i></a>.
+
+   <dt><dfn id=preferred-size-constraint>preferred-size constraint</dfn>
+
+   <dd> A sizing constraint imposed by the box's <i>containing block</i> that
+    causes it to produce its <a
+    href="#preferred-size-contribution"><i>preferred-size
+    contribution</i></a>.
   </dl>
 
   <h2 id=size-keywords><span class=secno>3. </span> New Sizing Keywords</h2>
@@ -1302,6 +1331,18 @@ <h2 class=no-num id=index> Index</h2>
    <li>min-size contribution, <a href="#min-size-contribution"
     title="section 2."><strong>2.</strong></a>
 
+   <li>preferred extent, <a href="#preferred-extent"
+    title="section 2."><strong>2.</strong></a>
+
+   <li>preferred measure, <a href="#preferred-measure"
+    title="section 2."><strong>2.</strong></a>
+
+   <li>preferred-size constraint, <a href="#preferred-size-constraint"
+    title="section 2."><strong>2.</strong></a>
+
+   <li>preferred-size contribution, <a href="#preferred-size-contribution"
+    title="section 2."><strong>2.</strong></a>
+
    <li>renderer, <a href="#renderer"
     title="section 6.2."><strong>6.2.</strong></a>
 

css-sizing/Overview.src.html

@@ -201,13 +201,18 @@ <h2 id="terms">
 		<dt><dfn>fit-content measure</dfn>
 		<dd>
 			If the <i>available</i> measure is finite,
-			equal to <code>min(<i>max-content</i>, max(<i>min-content</i>, <i>fill-available</i>))</code>.
+			equal to <code>min(<i>preferred measure</i>, max(<i>min-content measure</i>, <i>fill-available measure</i>))</code>.
 			Otherwise, equal to the <i>max-content measure</i>.
 
 			<p class='note'>
 				Note: This is called the <i>shrink-to-fit</i> width in <a href="http://www.w3.org/TR/CSS21/visudet.html#float-width">CSS2.1§10.3.5</a> 
 				and <a href="http://www.w3.org/TR/css3-multicol/#pseudo-algorithm">CSS Multi-column Layout § 3.4</a>.
 
+		<dt><dfn>preferred measure</dfn>
+		<dd>
+			A box’s “ideal” <i>measure</i>.
+			Unless otherwise specified, this is the <i>max-content measure</i>.
+
 		<dt><dfn>fill-available extent</dfn>
 		<dd>
 			Roughly, the <i>extent</i> a box would take
@@ -221,12 +226,24 @@ <h2 id="terms">
 		<dt><dfn>min-content extent</dfn>
 		<dd>
 			Equivalent to the <i>max-content extent</i>.
-			<span class="issue">Or should this be the minimum between allowed break points? It might make sense in multi-col contexts to have min-content and max-content extents be different, even if they are the same elsewhere.</span>
+
+			<p class="issue">
+				Or should this be the minimum between allowed break points?
+				It might make sense in multi-col contexts
+				to have min-content and max-content extents be different,
+				even if they are the same elsewhere.
 
 		<dt><dfn>fit-content extent</dfn>
 		<dd>
 			Analogous to the <i>fit-content measure</i>.
 
+		<dt><dfn>preferred extent</dfn>
+		<dd>
+			Equivalent to the <i>max-content extent</i>.
+
+			<p class='issue'>
+				Same issue as <i>min-content extent</i>.
+
 		<dt><dfn>max-size contribution</dfn>
 		<dd>
 			The size that a box contributes to its <i>containing block</i>'s <i>max-content size</i>.
@@ -235,6 +252,11 @@ <h2 id="terms">
 		<dd>
 			The size that a box contributes to its <i>containing block</i>'s <i>min-content size</i>.
 
+		<dt><dfn>preferred-size contribution</dfn>
+		<dd>
+			If the box's layout mode has a defined <i>preferred-size contribution</i>, that.
+			Otherwise, the box's <i>max-size contribution</i>.
+
 		<dt><dfn>max-size constraint</dfn>
 		<dd>
 			A sizing constraint imposed by the box's <i>containing block</i>
@@ -244,6 +266,11 @@ <h2 id="terms">
 		<dd>
 			A sizing constraint imposed by the box's <i>containing block</i>
 			that causes it to produce its <i>min-size contribution</i>.
+
+		<dt><dfn>preferred-size constraint</dfn>
+		<dd>
+			A sizing constraint imposed by the box's <i>containing block</i>
+			that causes it to produce its <i>preferred-size contribution</i>.
 	</dl>
 
 <h2 id='size-keywords'>