Skip to content

Commit 9917802

Browse files
fantasaifantasai
committed
Fill out remaining template replacements, add an issue, copy in dbaron's definition of max-cotent measure.
1 parent 47dbcb9 commit 9917802

3 files changed

Lines changed: 102 additions & 152 deletions

File tree

‎css3-sizing/Overview.html‎

Lines changed: 76 additions & 104 deletions
Original file line numberDiff line numberDiff line change
@@ -10,37 +10,18 @@
1010
<link href="http://www.w3.org/StyleSheets/TR/W3C-ED.css" rel=stylesheet
1111
type="text/css">
1212

13-
<style type="text/css">
14-
/* delete this block when you've cleared out all the .replaceme elements */
15-
.replaceme {
16-
border: solid red;
17-
padding: 0 0.5em;
18-
margin: 0 0.1em;
19-
background: yellow;
20-
color: green;
21-
}
22-
.replaceme:before {
23-
content: "FIXME(";
24-
color: black;
25-
}
26-
.replaceme:after {
27-
content: ")";
28-
color: black;
29-
}
30-
</style>
31-
3213
<body>
3314
<div class=head> <!--begin-logo-->
3415
<p><a href="http://www.w3.org/"><img alt=W3C height=48
3516
src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo-->
3617

3718
<h1>CSS Intrinsic &amp; Extrinsic Sizing Module Level 3</h1>
3819

39-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 1 August 2012</h2>
20+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 9 August 2012</h2>
4021

4122
<dl><!--
4223
<dt>This version:
43-
<dd><a href="http://www.w3.org/TR/2012/ED-css3-sizing-20120801/" class="replaceme">http://www.w3.org/TR/2012/ED-css3-sizing-20120801/</a>
24+
<dd><a href="http://www.w3.org/TR/2012/ED-css3-sizing-20120809/">http://www.w3.org/TR/2012/ED-css3-sizing-20120809/</a>
4425
-->
4526

4627
<dt>Latest version:
@@ -100,8 +81,10 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 1 August 2012</h2>
10081

10182
<h2 class="no-num no-toc" id=abstract>Abstract</h2>
10283

103-
<p>This module contains the features of CSS relating to <var
104-
class=replaceme>DESCRIBE HERE</var>. <a
84+
<p>This module extends the CSS sizing properties with keywords that
85+
represent content-based "intrinsic" sizes and context-based "extrinsic"
86+
sizes, allowing CSS to more easily describe boxes that fit their content
87+
or fit into a particular layout context. <a
10588
href="http://www.w3.org/TR/CSS/">CSS</a> is a language for describing the
10689
rendering of structured documents (such as HTML and XML) on screen, on
10790
paper, in speech, etc.
@@ -243,26 +226,15 @@ <h2 id=intro><span class=secno>1. </span> Introduction</h2>
243226

244227
<h3 id=placement><span class=secno>1.1. </span> Module interactions</h3>
245228

246-
<p class=replaceme>Explain, normatively, how this module affects the
247-
definition of CSS.
248-
249-
<p>This module replaces and extends the <var class=replaceme>SUMMARIZE
250-
HERE</var> features defined in <a href="#CSS21"
251-
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var
252-
class=replaceme>W.X and Y.Z</var>.
253-
254-
<p class=replaceme>All properties in this module apply to the
255-
<code>::first-line</code> and <code>::first-letter</code> pseudo-elements.
256-
<!-- HANDLE, THEN REMOVE THIS COMMENT
257-
Properties that affect box layout should be excluded from ::first-line.
258-
Properties that take things out-of-flow or alter box construction should
259-
be excluded from both ::first-line and ::first-letter. (A special exception
260-
is made for float on ::first-letter, which is defined to emulate drop-caps.)
261-
Examples of ::first-line / ::first-letter statements:
262-
http://dev.w3.org/csswg/css3-background/#placement
263-
(All properties apply to ::first-letter; some apply to ::first-line)
264-
-->
265-
229+
<p>This module extends the ‘<code class=property>width</code>’,
230+
‘<code class=property>height</code>’, ‘<code
231+
class=property>min-width</code>’, ‘<code
232+
class=property>min-height</code>’, ‘<code
233+
class=property>max-width</code>’, ‘<code
234+
class=property>max-height</code>’, and ‘<code
235+
class=property>column-width</code>’ features defined in <a href="#CSS21"
236+
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> chapter 10 and in
237+
[[!CSS3MULTICOL]]
266238

267239
<h3 id=values><span class=secno>1.2. </span> Values</h3>
268240

@@ -338,8 +310,8 @@ <h2 id=terms><span class=secno>2. </span> Terminology</h2>
338310
<dt><dfn id=max-content-measure>max-content measure</dfn>
339311

340312
<dd> Roughly, the narrowest measure a box could take while fitting around
341-
its contents if <em>none</em> of the optional soft wrap opportunities
342-
within the box were taken. The exact definition is given in XXX.
313+
its contents if <em>none</em> of the soft wrap opportunities within the
314+
box were taken. The exact definition is given in XXX.
343315
<p class=note> Note: This is called the <i>preferred width</i> in <a
344316
href="http://www.w3.org/TR/CSS21/visudet.html#float-width">CSS2.1§10.3.5</a>
345317
and the <i>maximum cell width</i> in <a
@@ -348,9 +320,11 @@ <h2 id=terms><span class=secno>2. </span> Terminology</h2>
348320

349321
<dt><dfn id=min-content-measure>min-content measure</dfn>
350322

351-
<dd> Roughly, the narrowest measure a box could take while fitting around
352-
its contents if <em>all</em> soft wrap opportunities within the box were
353-
taken. The exact definition is given in XXX.
323+
<dd> The narrowest measure a box could take that doesn't lead to
324+
inline-dimension overflow that could be avoided by choosing a larger
325+
measure. Roughly, the measure that would fit around its contents if
326+
<em>all</em> soft wrap opportunities within the box were taken. The exact
327+
definition is given in XXX.
354328
<p class=note> Note: This is called the <i>preferred minimum width</i> in
355329
<a
356330
href="http://www.w3.org/TR/CSS21/visudet.html#float-width">CSS2.1§10.3.5</a>
@@ -514,6 +488,10 @@ <h3 id=width-height-keywords><span class=secno>3.1. </span> New Keywords
514488
appropriate to the writing mode.
515489
</dl>
516490

491+
<p class=issue> Right now all of these except ‘<a
492+
href="#fill-available"><code class=css>fill-available</code></a>’ mean
493+
the same thing for extents. This may or may not be ideal.
494+
517495
<h3 id=the-contain-floats-value><span class=secno>3.2. </span> Containing
518496
Floats</h3>
519497

@@ -713,15 +691,15 @@ <h3 id=block-intrinsic><span class=secno>4.3. </span> Intrinsic Sizes of
713691
Non-Replaced Blocks</h3>
714692

715693
<p> The <a href="#min-content-measure"><i>min-content measure</i></a> of a
716-
block box is the largest <i>min-measure contribution</i> of its in-flow or
717-
floated children.
694+
<i>block container box</i> is the largest <i>min-measure contribution</i>
695+
of its in-flow or floated children.
718696

719697
<p> The <a href="#max-content-measure"><i>max-content measure</i></a> of a
720-
block box is the measure of the box after layout, if all children are
721-
sized under a <a href="#max-size-constraint"><i>max-size
698+
<i>block container box</i> is the measure of the box after layout, if all
699+
children are sized under a <a href="#max-size-constraint"><i>max-size
722700
constraint</i></a>.
723701

724-
<p> If the computed measure of a block box is ‘<a
702+
<p> If the computed measure of a <i>block-level box</i> is ‘<a
725703
href="#min-content"><code class=css>min-content</code></a>’, ‘<a
726704
href="#max-content"><code class=css>max-content</code></a>’, or a <a
727705
href="#definite-size"><i>definite size</i></a>, its <i>min-measure
@@ -733,7 +711,7 @@ <h3 id=block-intrinsic><span class=secno>4.3. </span> Intrinsic Sizes of
733711
contribution</i> is its <a href="#min-content-measure"><i>min-content
734712
measure</i></a> plus any inline-axis margin, border, and padding.
735713

736-
<p> If the computed measure of a block box is ‘<a
714+
<p> If the computed measure of a <i>block-level box</i> is ‘<a
737715
href="#min-content"><code class=css>min-content</code></a>’, ‘<a
738716
href="#max-content"><code class=css>max-content</code></a>’, or a <a
739717
href="#definite-size"><i>definite size</i></a>, its <i>max-measure
@@ -746,17 +724,18 @@ <h3 id=block-intrinsic><span class=secno>4.3. </span> Intrinsic Sizes of
746724
measure</i></a> plus any inline-axis margin, border, and padding.
747725

748726
<p> The <a href="#min-content-extent"><i>min-content extent</i></a> and <a
749-
href="#max-content-extent"><i>max-content extent</i></a> of a block box is
750-
the content extent as defined (for horizontal writing modes) in <a
727+
href="#max-content-extent"><i>max-content extent</i></a> of a <i>block
728+
container box</i> is the content extent as defined (for horizontal writing
729+
modes) in <a
751730
href="http://www.w3.org/TR/CSS21/visudet.html#normal-block">CSS2.1§10.6.3</a>
752731
and <a
753732
href="http://www.w3.org/TR/CSS21/tables.html#height-layout">CSS2.1§17.5.3</a>
754733
for elements with ‘<code class=css>height: auto</code>’, and
755734
analogously for vertical writing modes.
756735

757736
<p> The <i>min-extent contribution</i> and <i>max-extent contribution</i>
758-
of a block box is the extent of the block after layout, plus any
759-
block-axis margin, border, and padding.
737+
of a <i>block-level box</i> is the extent of the block after layout, plus
738+
any block-axis margin, border, and padding.
760739

761740
<h3 id=table-intrinsic><span class=secno>4.4. </span> Intrinsic Sizes in
762741
Table Layout</h3>
@@ -890,8 +869,8 @@ <h3 id=conventions><span class=secno>6.1. </span> Document conventions</h3>
890869
<h3 id=conformance-classes><span class=secno>6.2. </span> Conformance
891870
classes</h3>
892871

893-
<p>Conformance to <var class=replaceme>CSS Intrinsic Sizing Module</var> is
894-
defined for three conformance classes:
872+
<p>Conformance to CSS Intrinsic &amp; Extrinsic Sizing Level 3 is defined
873+
for three conformance classes:
895874

896875
<dl>
897876
<dt><dfn id=style-sheet title="style sheet!!as conformance class">style
@@ -912,25 +891,25 @@ <h3 id=conformance-classes><span class=secno>6.2. </span> Conformance
912891
that writes a style sheet.
913892
</dl>
914893

915-
<p>A style sheet is conformant to <var class=replaceme>CSS Intrinsic Sizing
916-
Module</var> if all of its statements that use syntax defined in this
917-
module are valid according to the generic CSS grammar and the individual
918-
grammars of each feature defined in this module.
919-
920-
<p>A renderer is conformant to <var class=replaceme>CSS Intrinsic Sizing
921-
Module</var> if, in addition to interpreting the style sheet as defined by
922-
the appropriate specifications, it supports all the features defined by
923-
<var class=replaceme>CSS Intrinsic Sizing Module</var> by parsing them
924-
correctly and rendering the document accordingly. However, the inability
925-
of a UA to correctly render a document due to limitations of the device
926-
does not make the UA non-conformant. (For example, a UA is not required to
927-
render color on a monochrome monitor.)
928-
929-
<p>An authoring tool is conformant to <var class=replaceme>CSS Intrinsic
930-
Sizing Module</var> if it writes style sheets that are syntactically
931-
correct according to the generic CSS grammar and the individual grammars
932-
of each feature in this module, and meet all other conformance
933-
requirements of style sheets as described in this module.
894+
<p>A style sheet is conformant to CSS Intrinsic &amp; Extrinsic Sizing
895+
Level 3 if all of its statements that use syntax defined in this module
896+
are valid according to the generic CSS grammar and the individual grammars
897+
of each feature defined in this module.
898+
899+
<p>A renderer is conformant to CSS Intrinsic &amp; Extrinsic Sizing Level 3
900+
if, in addition to interpreting the style sheet as defined by the
901+
appropriate specifications, it supports all the features defined by CSS
902+
Intrinsic &amp; Extrinsic Sizing Level 3 by parsing them correctly and
903+
rendering the document accordingly. However, the inability of a UA to
904+
correctly render a document due to limitations of the device does not make
905+
the UA non-conformant. (For example, a UA is not required to render color
906+
on a monochrome monitor.)
907+
908+
<p>An authoring tool is conformant to CSS Intrinsic &amp; Extrinsic Sizing
909+
Level 3 if it writes style sheets that are syntactically correct according
910+
to the generic CSS grammar and the individual grammars of each feature in
911+
this module, and meet all other conformance requirements of style sheets
912+
as described in this module.
934913

935914
<h3 id=partial><span class=secno>6.3. </span> Partial implementations</h3>
936915

@@ -1037,7 +1016,8 @@ <h3 id=cr-exit-criteria><span class=secno>6.6. </span> CR exit criteria</h3>
10371016

10381017
<h2 class=no-num id=acknowledgments> Acknowledgments</h2>
10391018

1040-
<p><var class=replaceme>[acknowledgments]</var>
1019+
<p>Special thanks go to Aaron Gustafson, L. David Baron for their
1020+
contributions to this module.
10411021

10421022
<h2 class=no-num id=references> References</h2>
10431023

@@ -1250,26 +1230,24 @@ <h2 class=no-num id=property-index> Property index</h2>
12501230

12511231
<tbody>
12521232
<tr>
1253-
<th><span class=property>‘column-width’</span>
1233+
<th><span class=property></span>
12541234

1255-
<td>‘min-content’ | ‘max-content’ | ‘fill-available’ |
1256-
‘fit-content’
1235+
<td>
12571236

1258-
<td>as defined in [CSS3COL]
1237+
<td>as defined in [CSS21] and [CSS3-FLEXBOX]
12591238

1260-
<td>as defined in [CSS3COL]
1239+
<td>as defined in [CSS21]
12611240

1262-
<td>as defined in [CSS3COL]
1241+
<td>as defined in [CSS21]
12631242

1264-
<td>as defined in [CSS3COL]
1243+
<td>as defined in [CSS21]
12651244

1266-
<td>as defined in [CSS3COL]
1245+
<td>as defined in [CSS21]
12671246

12681247
<tr>
1269-
<th><span class=property>‘min-width’</span>, <span
1270-
class=property>‘min-height’</span>
1248+
<th><span class=property></span>
12711249

1272-
<td>‘contain-floats’
1250+
<td>
12731251

12741252
<td>as defined in [CSS21] and [CSS3-FLEXBOX]
12751253

@@ -1282,25 +1260,19 @@ <h2 class=no-num id=property-index> Property index</h2>
12821260
<td>as defined in [CSS21]
12831261

12841262
<tr>
1285-
<th><span class=property>‘width’</span>, <span
1286-
class=property>‘min-width’</span>, <span
1287-
class=property>‘max-width’</span>, <span
1288-
class=property>‘height’</span>, <span
1289-
class=property>‘min-height’</span>, <span
1290-
class=property>‘max-height’</span>
1263+
<th><span class=property></span>
12911264

1292-
<td>‘fill-available’ | ‘max-content’ | ‘min-content’ |
1293-
‘fit-content’
1265+
<td>
12941266

1295-
<td>as defined in [CSS21] and [CSS3-FLEXBOX]
1267+
<td>as defined in [CSS3COL]
12961268

1297-
<td>as defined in [CSS21]
1269+
<td>as defined in [CSS3COL]
12981270

1299-
<td>as defined in [CSS21]
1271+
<td>as defined in [CSS3COL]
13001272

1301-
<td>as defined in [CSS21]
1273+
<td>as defined in [CSS3COL]
13021274

1303-
<td>as defined in [CSS21]
1275+
<td>as defined in [CSS3COL]
13041276
</table>
13051277
<!--end-properties-->
13061278
</html>

0 commit comments

Comments
 (0)