Wed, 17 Oct 2012 18:44:10 -0700
[css-display-3] First commit of the display module.
css-display-3/Overview.html | file | annotate | diff | comparison | revisions | |
css-display-3/Overview.src.html | file | annotate | diff | comparison | revisions |
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/css-display-3/Overview.html Wed Oct 17 18:44:10 2012 -0700 1.3 @@ -0,0 +1,1035 @@ 1.4 +<!DOCTYPE html> 1.5 + 1.6 +<html lang=en> 1.7 + <head> 1.8 + <meta content="text/html; charset=utf-8" http-equiv=Content-Type> 1.9 + <title>CSS Display Module Level 3</title> 1.10 + <!-- 1.11 + <link href="http://purl.org/dc/terms/" rel="schema.dcterms"> 1.12 + <link href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright" rel="dcterms.rights"> 1.13 + --> 1.14 + 1.15 + <meta content="CSS Display Module Level 3" name=dcterms.title> 1.16 + <meta content=text name=dcterms.type> 1.17 + <meta content=2012-10-18 name=dcterms.issued> 1.18 + <meta content="http://dev.w3.org/csswg/cssN-FIXME/" name=dcterms.creator> 1.19 + <meta content=W3C name=dcterms.publisher> 1.20 + <meta content="http://www.w3.org/TR/2012/ED-cssN-FIXME-20121018/" 1.21 + name=dcterms.identifier> 1.22 + <link href="#contents" rel=contents> 1.23 + <link href="#index" rel=index> 1.24 + <link href="../default.css" rel=stylesheet type="text/css"> 1.25 + <link href="http://www.w3.org/StyleSheets/TR/W3C-ED.css" rel=stylesheet 1.26 + type="text/css"> 1.27 + <style type="text/css"> 1.28 + /* delete this block when you've cleared out all the .replaceme elements */ 1.29 + .replaceme { 1.30 + border: solid red; 1.31 + padding: 0 0.5em; 1.32 + margin: 0 0.1em; 1.33 + background: yellow; 1.34 + color: green; 1.35 + } 1.36 + .replaceme:before { 1.37 + content: "FIXME("; 1.38 + color: black; 1.39 + } 1.40 + .replaceme:after { 1.41 + content: ")"; 1.42 + color: black; 1.43 + } 1.44 + </style> 1.45 + 1.46 + <body> 1.47 + <div class=head> <!--begin-logo--> 1.48 + <p><a href="http://www.w3.org/"><img alt=W3C height=48 1.49 + src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo--> 1.50 + 1.51 + <h1>CSS Display Module Level 3</h1> 1.52 + 1.53 + <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 18 October 1.54 + 2012</h2> 1.55 + 1.56 + <dl> 1.57 + <dt>This version: 1.58 + 1.59 + <dd><a class=replaceme 1.60 + href="http://www.w3.org/TR/2012/ED-cssN-FIXME-20121018/">http://www.w3.org/TR/2012/ED-cssN-FIXME-20121018/</a> 1.61 + 1.62 + <dt>Latest version: 1.63 + 1.64 + <dd><a 1.65 + href="http://www.w3.org/TR/cssN-FIXME/">http://www.w3.org/TR/cssN-FIXME/</a> 1.66 + 1.67 + <dt>Editor's draft: 1.68 + 1.69 + <dd><a 1.70 + href="http://dev.w3.org/csswg/cssN-FIXME/">http://dev.w3.org/csswg/cssN-FIXME/</a> 1.71 + 1.72 + <dt>Previous version: 1.73 + 1.74 + <dd><a href="http://www.w3.org/PreviousVersionURI"> 1.75 + http://www.w3.org/PreviousVersionURI</a> 1.76 + 1.77 + <dt>Issue Tracking: 1.78 + 1.79 + <dd><a 1.80 + href="http://www.w3.org/Style/CSS/Tracker/products/FIXME">http://www.w3.org/Style/CSS/Tracker/products/FIXME</a> 1.81 + 1.82 + <dt>Feedback: 1.83 + 1.84 + <dd><a 1.85 + href="http://lists.w3.org/Archives/Public/www-style/">www-style@w3.org</a> 1.86 + with subject line “<kbd>[cssN-FIXME] <var>… message topic 1.87 + …</var></kbd>” 1.88 + 1.89 + <dt>Editors: 1.90 + 1.91 + <dd class="h-card vcard"> <a class="p-name fn u-url url" 1.92 + href="http://www.xanthir.com/" rel=author>Tab Atkins Jr.</a> (<span 1.93 + class="p-org org">Google, Inc.</span>), <span 1.94 + class="u-email email">jackalmage@gmail.com</span> 1.95 + </dl> 1.96 + <!--begin-copyright--> 1.97 + <p class=copyright><a 1.98 + href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright" 1.99 + rel=license>Copyright</a> © 2012 <a href="http://www.w3.org/"><abbr 1.100 + title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a 1.101 + href="http://www.csail.mit.edu/"><abbr 1.102 + title="Massachusetts Institute of Technology">MIT</abbr></a>, <a 1.103 + href="http://www.ercim.eu/"><abbr 1.104 + title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, 1.105 + <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a 1.106 + href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, 1.107 + <a 1.108 + href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> 1.109 + and <a 1.110 + href="http://www.w3.org/Consortium/Legal/copyright-documents">document 1.111 + use</a> rules apply.</p> 1.112 + <!--end-copyright--> 1.113 + <hr title="Separator for header"> 1.114 + </div> 1.115 + 1.116 + <h2 class="no-num no-toc" id=abstract>Abstract</h2> 1.117 + 1.118 + <p> This module contains the features of CSS relating to the ‘<a 1.119 + href="#display"><code class=property>display</code></a>’ property. <a 1.120 + href="http://www.w3.org/TR/CSS/">CSS</a> is a language for describing the 1.121 + rendering of structured documents (such as HTML and XML) on screen, on 1.122 + paper, in speech, etc. 1.123 + 1.124 + <h2 class="no-num no-toc" id=status>Status of this document</h2> 1.125 + 1.126 + <p> This is currently a personal draft, not yet approved by the CSSWG to be 1.127 + an Editor's Draft. (Ignore the branding on the side and heading, which are 1.128 + artifacts of the spec generation process.) <!--//status--> 1.129 + 1.130 + <p>The following features are at risk: … 1.131 + 1.132 + <h2 class="no-num no-toc" id=contents> Table of contents</h2> 1.133 + <!--begin-toc--> 1.134 + 1.135 + <ul class=toc> 1.136 + <li><a href="#intro"><span class=secno>1. </span> Introduction</a> 1.137 + <ul class=toc> 1.138 + <li><a href="#placement"><span class=secno>1.1. </span> Module 1.139 + interactions</a> 1.140 + 1.141 + <li><a href="#values"><span class=secno>1.2. </span> Values</a> 1.142 + </ul> 1.143 + 1.144 + <li><a href="#the-display-properties"><span class=secno>2. </span> The 1.145 + Display Properties</a> 1.146 + <ul class=toc> 1.147 + <li><a href="#the-display-inside"><span class=secno>2.1. </span> Setting 1.148 + the layout mode: the ‘<code class=property>display-inside</code>’ 1.149 + property</a> 1.150 + 1.151 + <li><a href="#the-display-outside"><span class=secno>2.2. </span> 1.152 + Interacting with the layout mode: the ‘<code 1.153 + class=property>display-outside</code>’ property</a> 1.154 + 1.155 + <li><a href="#the-display-box"><span class=secno>2.3. </span> 1.156 + Controlling box generation: the ‘<code 1.157 + class=property>display-box</code>’ property</a> 1.158 + 1.159 + <li><a href="#the-display-extras"><span class=secno>2.4. </span> 1.160 + Additional stuff: the ‘<code class=property>display-extras</code>’ 1.161 + property</a> 1.162 + 1.163 + <li><a href="#the-display"><span class=secno>2.5. </span> The ‘<code 1.164 + class=property>display</code>’ shorthand property</a> 1.165 + </ul> 1.166 + 1.167 + <li><a href="#conformance"><span class=secno>3. </span> Conformance</a> 1.168 + <ul class=toc> 1.169 + <li><a href="#conventions"><span class=secno>3.1. </span> Document 1.170 + conventions</a> 1.171 + 1.172 + <li><a href="#conformance-classes"><span class=secno>3.2. </span> 1.173 + Conformance classes</a> 1.174 + 1.175 + <li><a href="#partial"><span class=secno>3.3. </span> Partial 1.176 + implementations</a> 1.177 + 1.178 + <li><a href="#experimental"><span class=secno>3.4. </span> Experimental 1.179 + implementations</a> 1.180 + 1.181 + <li><a href="#testing"><span class=secno>3.5. </span> Non-experimental 1.182 + implementations</a> 1.183 + 1.184 + <li><a href="#cr-exit-criteria"><span class=secno>3.6. </span> CR exit 1.185 + criteria</a> 1.186 + </ul> 1.187 + 1.188 + <li class=no-num><a href="#acknowledgments"> Acknowledgments</a> 1.189 + 1.190 + <li class=no-num><a href="#references"> References</a> 1.191 + <ul class=toc> 1.192 + <li class=no-num><a href="#normative-references"> Normative 1.193 + references</a> 1.194 + 1.195 + <li class=no-num><a href="#other-references"> Other references</a> 1.196 + </ul> 1.197 + 1.198 + <li class=no-num><a href="#index"> Index</a> 1.199 + 1.200 + <li class=no-num><a href="#property-index"> Property index</a> 1.201 + </ul> 1.202 + <!--end-toc--> 1.203 + 1.204 + <h2 id=intro><span class=secno>1. </span> Introduction</h2> 1.205 + 1.206 + <p><em>This section is not normative.</em> 1.207 + 1.208 + <p> <var class=replaceme>Provide background, motivation, etc.</var> 1.209 + 1.210 + <h3 id=placement><span class=secno>1.1. </span> Module interactions</h3> 1.211 + 1.212 + <p class=replaceme> Explain, normatively, how this module affects the 1.213 + definition of CSS. 1.214 + 1.215 + <p> This module replaces and extends the <var class=replaceme>SUMMARIZE 1.216 + HERE</var> features defined in <a href="#CSS21" 1.217 + rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var 1.218 + class=replaceme>W.X and Y.Z</var>. 1.219 + 1.220 + <p> None of the properties in this module apply to the 1.221 + <code>::first-line</code> or <code>::first-letter</code> pseudo-elements. 1.222 + 1.223 + <h3 id=values><span class=secno>1.2. </span> Values</h3> 1.224 + 1.225 + <p>This specification follows the <a 1.226 + href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property 1.227 + definition conventions</a> from <a href="#CSS21" 1.228 + rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>. Value types not defined in 1.229 + this specification are defined in CSS Level 2 Revision 1 <a 1.230 + href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>. Other CSS 1.231 + modules may expand the definitions of these value types: for example <a 1.232 + href="#CSS3COLOR" rel=biblioentry>[CSS3COLOR]<!--{{CSS3COLOR}}--></a>, 1.233 + when combined with this module, expands the definition of the 1.234 + <color> value type as used in this specification. 1.235 + 1.236 + <p>In addition to the property-specific values listed in their definitions, 1.237 + all properties defined in this specification also accept the <a 1.238 + href="http://www.w3.org/TR/CSS21/cascade.html#value-def-inherit">inherit</a> 1.239 + keyword as their property value. For readability it has not been repeated 1.240 + explicitly. 1.241 + 1.242 + <h2 id=the-display-properties><span class=secno>2. </span> The Display 1.243 + Properties</h2> 1.244 + 1.245 + <p> ... 1.246 + 1.247 + <h3 id=the-display-inside><span class=secno>2.1. </span> Setting the layout 1.248 + mode: the ‘<a href="#display-inside"><code 1.249 + class=property>display-inside</code></a>’ property</h3> 1.250 + 1.251 + <table class=propdef> 1.252 + <tbody> 1.253 + <tr> 1.254 + <th>Name: 1.255 + 1.256 + <td><dfn id=display-inside>display-inside</dfn> 1.257 + 1.258 + <tr> 1.259 + <th>Value: 1.260 + 1.261 + <td>block-inside | text | table | table-inside | flex | grid 1.262 + 1.263 + <tr> 1.264 + <th>Initial: 1.265 + 1.266 + <td>inline 1.267 + 1.268 + <tr> 1.269 + <th>Applies To: 1.270 + 1.271 + <td>all elements 1.272 + 1.273 + <tr> 1.274 + <th>Inherited: 1.275 + 1.276 + <td>no 1.277 + 1.278 + <tr> 1.279 + <th>Percentages: 1.280 + 1.281 + <td>N/A 1.282 + 1.283 + <tr> 1.284 + <th>Computed Value: 1.285 + 1.286 + <td>a keyword 1.287 + </table> 1.288 + 1.289 + <p class=issue> Not super happy with the names ‘<code 1.290 + class=css>block-inside</code>’ and ‘<code class=css>text</code>’, 1.291 + but I need ‘<a href="#display-inside"><code 1.292 + class=property>display-inside</code></a>’ and ‘<a 1.293 + href="#display-outside"><code class=property>display-outside</code></a>’ 1.294 + to have unique sets of values. 1.295 + 1.296 + <dl></dl> 1.297 + 1.298 + <p> ... 1.299 + 1.300 + <h3 id=the-display-outside><span class=secno>2.2. </span> Interacting with 1.301 + the layout mode: the ‘<a href="#display-outside"><code 1.302 + class=property>display-outside</code></a>’ property</h3> 1.303 + 1.304 + <table class=propdef> 1.305 + <tbody> 1.306 + <tr> 1.307 + <th>Name: 1.308 + 1.309 + <td><dfn id=display-outside>display-outside</dfn> 1.310 + 1.311 + <tr> 1.312 + <th>Value: 1.313 + 1.314 + <td>block | inline | table-row-group | table-header-group | 1.315 + table-footer-group | table-row | table-cell | table-column-group | 1.316 + table-column | table-caption 1.317 + 1.318 + <tr> 1.319 + <th>Initial: 1.320 + 1.321 + <td>inline 1.322 + 1.323 + <tr> 1.324 + <th>Applies To: 1.325 + 1.326 + <td>all elements 1.327 + 1.328 + <tr> 1.329 + <th>Inherited: 1.330 + 1.331 + <td>no 1.332 + 1.333 + <tr> 1.334 + <th>Percentages: 1.335 + 1.336 + <td>N/A 1.337 + 1.338 + <tr> 1.339 + <th>Computed Value: 1.340 + 1.341 + <td>as specified 1.342 + </table> 1.343 + 1.344 + <h3 id=the-display-box><span class=secno>2.3. </span> Controlling box 1.345 + generation: the ‘<a href="#display-box"><code 1.346 + class=property>display-box</code></a>’ property</h3> 1.347 + 1.348 + <table class=propdef> 1.349 + <tbody> 1.350 + <tr> 1.351 + <th>Name: 1.352 + 1.353 + <td><dfn id=display-box>display-box</dfn> 1.354 + 1.355 + <tr> 1.356 + <th>Value: 1.357 + 1.358 + <td>normal | none | contents 1.359 + 1.360 + <tr> 1.361 + <th>Initial: 1.362 + 1.363 + <td>normal 1.364 + 1.365 + <tr> 1.366 + <th>Applies To: 1.367 + 1.368 + <td>all elements 1.369 + 1.370 + <tr> 1.371 + <th>Inherited: 1.372 + 1.373 + <td>no 1.374 + 1.375 + <tr> 1.376 + <th>Percentages: 1.377 + 1.378 + <td>N/A 1.379 + 1.380 + <tr> 1.381 + <th>Computed Value: 1.382 + 1.383 + <td>as specified 1.384 + </table> 1.385 + 1.386 + <dl> 1.387 + <dt><dfn id="display-box:normal">normal</dfn> 1.388 + 1.389 + <dd> The element generates boxes as normal, per its other ‘<code 1.390 + class=css>display-*</code>’ properties. 1.391 + 1.392 + <dt><dfn id="display-box:none">none</dfn> 1.393 + 1.394 + <dd> The element generates no boxes at all. 1.395 + 1.396 + <dt><dfn id="display-box:contents">contents</dfn> 1.397 + 1.398 + <dd> The element itself does not generate any boxes, but its children and 1.399 + pseudo-elements still generate boxes as normal, as if the set of children 1.400 + and psuedo-elements completely replaced the element itself in the 1.401 + document. 1.402 + </dl> 1.403 + 1.404 + <p class=issue> Is there a need for a value that suppresses box generation 1.405 + for layout purposes, but still generates them for the purposes of 1.406 + animations/counters/etc.? 1.407 + 1.408 + <h3 id=the-display-extras><span class=secno>2.4. </span> Additional stuff: 1.409 + the ‘<a href="#display-extras"><code 1.410 + class=property>display-extras</code></a>’ property</h3> 1.411 + 1.412 + <table class=propdef> 1.413 + <tbody> 1.414 + <tr> 1.415 + <th>Name: 1.416 + 1.417 + <td><dfn id=display-extras>display-extras</dfn> 1.418 + 1.419 + <tr> 1.420 + <th>Value: 1.421 + 1.422 + <td>none | [ list-item ] 1.423 + 1.424 + <tr> 1.425 + <th>Initial: 1.426 + 1.427 + <td>none 1.428 + 1.429 + <tr> 1.430 + <th>Applies To: 1.431 + 1.432 + <td>all elements 1.433 + 1.434 + <tr> 1.435 + <th>Inherited: 1.436 + 1.437 + <td>no 1.438 + 1.439 + <tr> 1.440 + <th>Percentages: 1.441 + 1.442 + <td>N/A 1.443 + 1.444 + <tr> 1.445 + <th>Computed Value: 1.446 + 1.447 + <td>as specified 1.448 + </table> 1.449 + 1.450 + <dl> 1.451 + <dt><dfn id="display-extras:list-item">list-item</dfn> 1.452 + 1.453 + <dd> The element generates a <code>::marker</code> pseudo-element and is 1.454 + considered a <a href="../css3-lists/#list-item">list item</a>. 1.455 + </dl> 1.456 + 1.457 + <h3 id=the-display><span class=secno>2.5. </span> The ‘<a 1.458 + href="#display"><code class=property>display</code></a>’ shorthand 1.459 + property</h3> 1.460 + 1.461 + <table class=propdef> 1.462 + <tbody> 1.463 + <tr> 1.464 + <th>Name: 1.465 + 1.466 + <td><dfn id=display>display</dfn> 1.467 + 1.468 + <tr> 1.469 + <th>Value: 1.470 + 1.471 + <td>inline | block | list-item | inline-block | table | inline-table | 1.472 + table-row-group | table-header-group | table-footer-group | table-row | 1.473 + table-column-group | table-column | table-cell | table-caption | none | 1.474 + [ <‘<a href="#display-inside"><code 1.475 + class=property>display-inside</code></a>’> || <‘<a 1.476 + href="#display-outside"><code 1.477 + class=property>display-outside</code></a>’> || <‘<a 1.478 + href="#display-box"><code class=property>display-box</code></a>’> || 1.479 + <‘<a href="#display-extras"><code 1.480 + class=property>display-extras</code></a>’> ] 1.481 + 1.482 + <tr> 1.483 + <th>Initial: 1.484 + 1.485 + <td>inline 1.486 + 1.487 + <tr> 1.488 + <th>Applies To: 1.489 + 1.490 + <td>all elements 1.491 + 1.492 + <tr> 1.493 + <th>Inherited: 1.494 + 1.495 + <td>no 1.496 + 1.497 + <tr> 1.498 + <th>Percentages: 1.499 + 1.500 + <td>N/A 1.501 + 1.502 + <tr> 1.503 + <th>Computed Value: 1.504 + 1.505 + <td>N/A 1.506 + </table> 1.507 + 1.508 + <p> The single-keyword values listed explicitly in the grammar above are 1.509 + handled specially, for legacy reasons. All other single-keyword values, 1.510 + and all other values in general, are handled as normal for shorthands. 1.511 + 1.512 + <dl> 1.513 + <dt><dfn id="display:inline">inline</dfn> 1.514 + 1.515 + <dd> Expands identically to ‘<code class=css>inline text</code>’. 1.516 + 1.517 + <dt><dfn id="display:block">block</dfn> 1.518 + 1.519 + <dd> Expands identically to ‘<code class=css>block 1.520 + block-inside</code>’. 1.521 + 1.522 + <dt><dfn id="display:list-item">list-item</dfn> 1.523 + 1.524 + <dd> Expands identically to ‘<code class=css>block block-inside 1.525 + list-item</code>’. 1.526 + 1.527 + <dt><dfn id="display:inline-block">inline-block</dfn> 1.528 + 1.529 + <dd> Expands identically to ‘<code class=css>inline 1.530 + block-inside</code>’. 1.531 + 1.532 + <dt><dfn id="display:table">table</dfn> 1.533 + 1.534 + <dd> Expands identically to ‘<code class=css>block table</code>’. 1.535 + 1.536 + <dt><dfn id="display:inline-table">inline-table</dfn> 1.537 + 1.538 + <dd> Expands identically to ‘<code class=css>inline table</code>’. 1.539 + 1.540 + <dt><dfn id="display:table-row-group">table-row-group</dfn>, <dfn 1.541 + id="display:table-header-group">table-header-group</dfn>, <dfn 1.542 + id="display:table-footer-group">table-footer-group</dfn>, <dfn 1.543 + id="display:table-row">table-row</dfn>, <dfn 1.544 + id="display:table-column-group">table-column-group</dfn>, <dfn 1.545 + id="display:table-column">table-column</dfn> 1.546 + 1.547 + <dd> Expands identically to ‘<code class=css>[the value] 1.548 + table-inside</code>’. 1.549 + 1.550 + <dt><dfn id="display:table-caption">table-caption</dfn> 1.551 + 1.552 + <dd> Expands identically to ‘<code class=css>table-caption 1.553 + block-inside</code>’. 1.554 + 1.555 + <dt><dfn id="display:table-cell">table-cell</dfn> 1.556 + 1.557 + <dd> Expands identically to ‘<code class=css>table-cell 1.558 + block-inside</code>’. 1.559 + 1.560 + <dt><dfn id="display:none">none</dfn> 1.561 + 1.562 + <dd> Expands identically to ‘<code class=css>inline text none</code>’. 1.563 + </dl> 1.564 + <!-- 1.565 + 1.566 +TTTTTTTTTTTTTTTTTTTTTTTHHHHHHHHH HHHHHHHHHEEEEEEEEEEEEEEEEEEEEEE 1.567 +T:::::::::::::::::::::TH:::::::H H:::::::HE::::::::::::::::::::E 1.568 +T:::::::::::::::::::::TH:::::::H H:::::::HE::::::::::::::::::::E 1.569 +T:::::TT:::::::TT:::::THH::::::H H::::::HHEE::::::EEEEEEEEE::::E 1.570 +TTTTTT T:::::T TTTTTT H:::::H H:::::H E:::::E EEEEEE 1.571 + T:::::T H:::::H H:::::H E:::::E 1.572 + T:::::T H::::::HHHHH::::::H E::::::EEEEEEEEEE 1.573 + T:::::T H:::::::::::::::::H E:::::::::::::::E 1.574 + T:::::T H:::::::::::::::::H E:::::::::::::::E 1.575 + T:::::T H::::::HHHHH::::::H E::::::EEEEEEEEEE 1.576 + T:::::T H:::::H H:::::H E:::::E 1.577 + T:::::T H:::::H H:::::H E:::::E EEEEEE 1.578 + TT:::::::TT HH::::::H H::::::HHEE::::::EEEEEEEE:::::E 1.579 + T:::::::::T H:::::::H H:::::::HE::::::::::::::::::::E 1.580 + T:::::::::T H:::::::H H:::::::HE::::::::::::::::::::E 1.581 + TTTTTTTTTTT HHHHHHHHH HHHHHHHHHEEEEEEEEEEEEEEEEEEEEEE 1.582 + 1.583 + 1.584 + 1.585 +EEEEEEEEEEEEEEEEEEEEEENNNNNNNN NNNNNNNNDDDDDDDDDDDDD 1.586 +E::::::::::::::::::::EN:::::::N N::::::ND::::::::::::DDD 1.587 +E::::::::::::::::::::EN::::::::N N::::::ND:::::::::::::::DD 1.588 +EE::::::EEEEEEEEE::::EN:::::::::N N::::::NDDD:::::DDDDD:::::D 1.589 + E:::::E EEEEEEN::::::::::N N::::::N D:::::D D:::::D 1.590 + E:::::E N:::::::::::N N::::::N D:::::D D:::::D 1.591 + E::::::EEEEEEEEEE N:::::::N::::N N::::::N D:::::D D:::::D 1.592 + E:::::::::::::::E N::::::N N::::N N::::::N D:::::D D:::::D 1.593 + E:::::::::::::::E N::::::N N::::N:::::::N D:::::D D:::::D 1.594 + E::::::EEEEEEEEEE N::::::N N:::::::::::N D:::::D D:::::D 1.595 + E:::::E N::::::N N::::::::::N D:::::D D:::::D 1.596 + E:::::E EEEEEEN::::::N N:::::::::N D:::::D D:::::D 1.597 +EE::::::EEEEEEEE:::::EN::::::N N::::::::NDDD:::::DDDDD:::::D 1.598 +E::::::::::::::::::::EN::::::N N:::::::ND:::::::::::::::DD 1.599 +E::::::::::::::::::::EN::::::N N::::::ND::::::::::::DDD 1.600 +EEEEEEEEEEEEEEEEEEEEEENNNNNNNN NNNNNNNDDDDDDDDDDDDD 1.601 +--> 1.602 + 1.603 + <h2 id=conformance><span class=secno>3. </span> Conformance</h2> 1.604 + 1.605 + <h3 id=conventions><span class=secno>3.1. </span> Document conventions</h3> 1.606 + 1.607 + <p>Conformance requirements are expressed with a combination of descriptive 1.608 + assertions and RFC 2119 terminology. The key words “MUST”, “MUST 1.609 + NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, 1.610 + “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the 1.611 + normative parts of this document are to be interpreted as described in RFC 1.612 + 2119. However, for readability, these words do not appear in all uppercase 1.613 + letters in this specification. 1.614 + 1.615 + <p>All of the text of this specification is normative except sections 1.616 + explicitly marked as non-normative, examples, and notes. <a 1.617 + href="#RFC2119" rel=biblioentry>[RFC2119]<!--{{!RFC2119}}--></a> 1.618 + 1.619 + <p>Examples in this specification are introduced with the words “for 1.620 + example” or are set apart from the normative text with 1.621 + <code>class="example"</code>, like this: 1.622 + 1.623 + <div class=example> 1.624 + <p>This is an example of an informative example. 1.625 + </div> 1.626 + 1.627 + <p>Informative notes begin with the word “Note” and are set apart from 1.628 + the normative text with <code>class="note"</code>, like this: 1.629 + 1.630 + <p class=note>Note, this is an informative note. 1.631 + 1.632 + <h3 id=conformance-classes><span class=secno>3.2. </span> Conformance 1.633 + classes</h3> 1.634 + 1.635 + <p>Conformance to <var class=replaceme>CSS TEMPLATE Module</var> is defined 1.636 + for three conformance classes: 1.637 + 1.638 + <dl> 1.639 + <dt><dfn id=style-sheet title="style sheet!!as conformance class">style 1.640 + sheet</dfn> 1.641 + 1.642 + <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS 1.643 + style sheet</a>. 1.644 + 1.645 + <dt><dfn id=renderer>renderer</dfn> 1.646 + 1.647 + <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> 1.648 + that interprets the semantics of a style sheet and renders documents that 1.649 + use them. 1.650 + 1.651 + <dt><dfn id=authoring-tool>authoring tool</dfn> 1.652 + 1.653 + <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> 1.654 + that writes a style sheet. 1.655 + </dl> 1.656 + 1.657 + <p>A style sheet is conformant to <var class=replaceme>CSS TEMPLATE 1.658 + Module</var> if all of its statements that use syntax defined in this 1.659 + module are valid according to the generic CSS grammar and the individual 1.660 + grammars of each feature defined in this module. 1.661 + 1.662 + <p>A renderer is conformant to <var class=replaceme>CSS TEMPLATE 1.663 + Module</var> if, in addition to interpreting the style sheet as defined by 1.664 + the appropriate specifications, it supports all the features defined by 1.665 + <var class=replaceme>CSS TEMPLATE Module</var> by parsing them correctly 1.666 + and rendering the document accordingly. However, the inability of a UA to 1.667 + correctly render a document due to limitations of the device does not make 1.668 + the UA non-conformant. (For example, a UA is not required to render color 1.669 + on a monochrome monitor.) 1.670 + 1.671 + <p>An authoring tool is conformant to <var class=replaceme>CSS TEMPLATE 1.672 + Module</var> if it writes style sheets that are syntactically correct 1.673 + according to the generic CSS grammar and the individual grammars of each 1.674 + feature in this module, and meet all other conformance requirements of 1.675 + style sheets as described in this module. 1.676 + 1.677 + <h3 id=partial><span class=secno>3.3. </span> Partial implementations</h3> 1.678 + 1.679 + <p>So that authors can exploit the forward-compatible parsing rules to 1.680 + assign fallback values, CSS renderers <strong>must</strong> treat as 1.681 + invalid (and <a 1.682 + href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore as 1.683 + appropriate</a>) any at-rules, properties, property values, keywords, and 1.684 + other syntactic constructs for which they have no usable level of support. 1.685 + In particular, user agents <strong>must not</strong> selectively ignore 1.686 + unsupported component values and honor supported values in a single 1.687 + multi-value property declaration: if any value is considered invalid (as 1.688 + unsupported values must be), CSS requires that the entire declaration be 1.689 + ignored. 1.690 + 1.691 + <h3 id=experimental><span class=secno>3.4. </span> Experimental 1.692 + implementations</h3> 1.693 + 1.694 + <p>To avoid clashes with future CSS features, the CSS2.1 specification 1.695 + reserves a <a 1.696 + href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed 1.697 + syntax</a> for proprietary and experimental extensions to CSS. 1.698 + 1.699 + <p>Prior to a specification reaching the Candidate Recommendation stage in 1.700 + the W3C process, all implementations of a CSS feature are considered 1.701 + experimental. The CSS Working Group recommends that implementations use a 1.702 + vendor-prefixed syntax for such features, including those in W3C Working 1.703 + Drafts. This avoids incompatibilities with future changes in the draft. 1.704 + 1.705 + <h3 id=testing><span class=secno>3.5. </span> Non-experimental 1.706 + implementations</h3> 1.707 + 1.708 + <p>Once a specification reaches the Candidate Recommendation stage, 1.709 + non-experimental implementations are possible, and implementors should 1.710 + release an unprefixed implementation of any CR-level feature they can 1.711 + demonstrate to be correctly implemented according to spec. 1.712 + 1.713 + <p>To establish and maintain the interoperability of CSS across 1.714 + implementations, the CSS Working Group requests that non-experimental CSS 1.715 + renderers submit an implementation report (and, if necessary, the 1.716 + testcases used for that implementation report) to the W3C before releasing 1.717 + an unprefixed implementation of any CSS features. Testcases submitted to 1.718 + W3C are subject to review and correction by the CSS Working Group. 1.719 + 1.720 + <p>Further information on submitting testcases and implementation reports 1.721 + can be found from on the CSS Working Group's website at <a 1.722 + href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>. 1.723 + Questions should be directed to the <a 1.724 + href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a> 1.725 + mailing list. 1.726 + 1.727 + <h3 id=cr-exit-criteria><span class=secno>3.6. </span> CR exit criteria</h3> 1.728 + 1.729 + <p class=replaceme>Remove this section unless/until the module is in CR.</p> 1.730 + <!-- This text was <a href="http://www.w3.org/Style/CSS/Tracker/actions/44"> decided on 2008-06-04.</a> --> 1.731 + 1.732 + <p> For this specification to be advanced to Proposed Recommendation, there 1.733 + must be at least two independent, interoperable implementations of each 1.734 + feature. Each feature may be implemented by a different set of products, 1.735 + there is no requirement that all features be implemented by a single 1.736 + product. For the purposes of this criterion, we define the following 1.737 + terms: 1.738 + 1.739 + <dl> 1.740 + <dt>independent 1.741 + 1.742 + <dd>each implementation must be developed by a different party and cannot 1.743 + share, reuse, or derive from code used by another qualifying 1.744 + implementation. Sections of code that have no bearing on the 1.745 + implementation of this specification are exempt from this requirement. 1.746 + 1.747 + <dt>interoperable 1.748 + 1.749 + <dd>passing the respective test case(s) in the official CSS test suite, 1.750 + or, if the implementation is not a Web browser, an equivalent test. Every 1.751 + relevant test in the test suite should have an equivalent test created if 1.752 + such a user agent (UA) is to be used to claim interoperability. In 1.753 + addition if such a UA is to be used to claim interoperability, then there 1.754 + must one or more additional UAs which can also pass those equivalent 1.755 + tests in the same way for the purpose of interoperability. The equivalent 1.756 + tests must be made publicly available for the purposes of peer review. 1.757 + 1.758 + <dt>implementation 1.759 + 1.760 + <dd>a user agent which: 1.761 + <ol class=inline> 1.762 + <li>implements the specification. 1.763 + 1.764 + <li>is available to the general public. The implementation may be a 1.765 + shipping product or other publicly available version (i.e., beta 1.766 + version, preview release, or “nightly build”). Non-shipping product 1.767 + releases must have implemented the feature(s) for a period of at least 1.768 + one month in order to demonstrate stability. 1.769 + 1.770 + <li>is not experimental (i.e., a version specifically designed to pass 1.771 + the test suite and is not intended for normal usage going forward). 1.772 + </ol> 1.773 + </dl> 1.774 + 1.775 + <p>The specification will remain Candidate Recommendation for at least six 1.776 + months. 1.777 + 1.778 + <h2 class=no-num id=acknowledgments> Acknowledgments</h2> 1.779 + 1.780 + <p><var class=replaceme>[acknowledgments]</var> 1.781 + 1.782 + <h2 class=no-num id=references> References</h2> 1.783 + 1.784 + <h3 class=no-num id=normative-references> Normative references</h3> 1.785 + <!--begin-normative--> 1.786 + <!-- Sorted by label --> 1.787 + 1.788 + <dl class=bibliography> 1.789 + <dt style="display: none"><!-- keeps the doc valid if the DL is empty --> 1.790 + <!----> 1.791 + 1.792 + <dt id=CSS21>[CSS21] 1.793 + 1.794 + <dd>Bert Bos; et al. <a 1.795 + href="http://www.w3.org/TR/2011/REC-CSS2-20110607"><cite>Cascading Style 1.796 + Sheets Level 2 Revision 1 (CSS 2.1) Specification.</cite></a> 7 June 1.797 + 2011. W3C Recommendation. URL: <a 1.798 + href="http://www.w3.org/TR/2011/REC-CSS2-20110607">http://www.w3.org/TR/2011/REC-CSS2-20110607</a> 1.799 + </dd> 1.800 + <!----> 1.801 + 1.802 + <dt id=RFC2119>[RFC2119] 1.803 + 1.804 + <dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key 1.805 + words for use in RFCs to Indicate Requirement Levels.</cite></a> Internet 1.806 + RFC 2119. URL: <a 1.807 + href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a> 1.808 + </dd> 1.809 + <!----> 1.810 + </dl> 1.811 + <!--end-normative--> 1.812 + 1.813 + <h3 class=no-num id=other-references> Other references</h3> 1.814 + <!--begin-informative--> 1.815 + <!-- Sorted by label --> 1.816 + 1.817 + <dl class=bibliography> 1.818 + <dt style="display: none"><!-- keeps the doc valid if the DL is empty --> 1.819 + <!----> 1.820 + 1.821 + <dt id=CSS3COLOR>[CSS3COLOR] 1.822 + 1.823 + <dd>Tantek Çelik; Chris Lilley; L. David Baron. <a 1.824 + href="http://www.w3.org/TR/2011/REC-css3-color-20110607"><cite>CSS Color 1.825 + Module Level 3.</cite></a> 7 June 2011. W3C Recommendation. URL: <a 1.826 + href="http://www.w3.org/TR/2011/REC-css3-color-20110607">http://www.w3.org/TR/2011/REC-css3-color-20110607</a> 1.827 + </dd> 1.828 + <!----> 1.829 + </dl> 1.830 + <!--end-informative--> 1.831 + 1.832 + <h2 class=no-num id=index> Index</h2> 1.833 + <!--begin-index--> 1.834 + 1.835 + <ul class=indexlist> 1.836 + <li>authoring tool, <a href="#authoring-tool" 1.837 + title="authoring tool"><strong>3.2.</strong></a> 1.838 + 1.839 + <li>block, <a href="#display:block" title=block><strong>2.5.</strong></a> 1.840 + 1.841 + <li>contents, <a href="#display-box:contents" 1.842 + title=contents><strong>2.3.</strong></a> 1.843 + 1.844 + <li>display, <a href="#display" title=display><strong>2.5.</strong></a> 1.845 + 1.846 + <li>display-box, <a href="#display-box" 1.847 + title=display-box><strong>2.3.</strong></a> 1.848 + 1.849 + <li>display-extras, <a href="#display-extras" 1.850 + title=display-extras><strong>2.4.</strong></a> 1.851 + 1.852 + <li>display-inside, <a href="#display-inside" 1.853 + title=display-inside><strong>2.1.</strong></a> 1.854 + 1.855 + <li>display-outside, <a href="#display-outside" 1.856 + title=display-outside><strong>2.2.</strong></a> 1.857 + 1.858 + <li>inline, <a href="#display:inline" 1.859 + title=inline><strong>2.5.</strong></a> 1.860 + 1.861 + <li>inline-block, <a href="#display:inline-block" 1.862 + title=inline-block><strong>2.5.</strong></a> 1.863 + 1.864 + <li>inline-table, <a href="#display:inline-table" 1.865 + title=inline-table><strong>2.5.</strong></a> 1.866 + 1.867 + <li>list-item, <a href="#display-extras:list-item" 1.868 + title=list-item><strong>2.4.</strong></a>, <a href="#display:list-item" 1.869 + title=list-item><strong>2.5.</strong></a> 1.870 + 1.871 + <li>none, <a href="#display-box:none" 1.872 + title=none><strong>2.3.</strong></a>, <a href="#display:none" 1.873 + title=none><strong>2.5.</strong></a> 1.874 + 1.875 + <li>normal, <a href="#display-box:normal" 1.876 + title=normal><strong>2.3.</strong></a> 1.877 + 1.878 + <li>renderer, <a href="#renderer" title=renderer><strong>3.2.</strong></a> 1.879 + 1.880 + <li>style sheet 1.881 + <ul> 1.882 + <li>as conformance class, <a href="#style-sheet" 1.883 + title="style sheet, as conformance class"><strong>3.2.</strong></a> 1.884 + </ul> 1.885 + 1.886 + <li>table, <a href="#display:table" title=table><strong>2.5.</strong></a> 1.887 + 1.888 + <li>table-caption, <a href="#display:table-caption" 1.889 + title=table-caption><strong>2.5.</strong></a> 1.890 + 1.891 + <li>table-cell, <a href="#display:table-cell" 1.892 + title=table-cell><strong>2.5.</strong></a> 1.893 + 1.894 + <li>table-column, <a href="#display:table-column" 1.895 + title=table-column><strong>2.5.</strong></a> 1.896 + 1.897 + <li>table-column-group, <a href="#display:table-column-group" 1.898 + title=table-column-group><strong>2.5.</strong></a> 1.899 + 1.900 + <li>table-footer-group, <a href="#display:table-footer-group" 1.901 + title=table-footer-group><strong>2.5.</strong></a> 1.902 + 1.903 + <li>table-header-group, <a href="#display:table-header-group" 1.904 + title=table-header-group><strong>2.5.</strong></a> 1.905 + 1.906 + <li>table-row, <a href="#display:table-row" 1.907 + title=table-row><strong>2.5.</strong></a> 1.908 + 1.909 + <li>table-row-group, <a href="#display:table-row-group" 1.910 + title=table-row-group><strong>2.5.</strong></a> 1.911 + </ul> 1.912 + <!--end-index--> 1.913 + 1.914 + <h2 class=no-num id=property-index> Property index</h2> 1.915 + <!--begin-properties--> 1.916 + 1.917 + <table class=proptable> 1.918 + <thead> 1.919 + <tr> 1.920 + <th>Property 1.921 + 1.922 + <th>Values 1.923 + 1.924 + <th>Initial 1.925 + 1.926 + <th>Applies to 1.927 + 1.928 + <th>Inh. 1.929 + 1.930 + <th>Percentages 1.931 + 1.932 + <th>Media 1.933 + 1.934 + <tbody> 1.935 + <tr> 1.936 + <th><a class=property href="#display-box">display-box</a> 1.937 + 1.938 + <td>normal | none | contents 1.939 + 1.940 + <td>normal 1.941 + 1.942 + <td>all elements 1.943 + 1.944 + <td>no 1.945 + 1.946 + <td>N/A 1.947 + 1.948 + <td> 1.949 + 1.950 + <tr> 1.951 + <th><a class=property href="#display-extras">display-extras</a> 1.952 + 1.953 + <td>none | [ list-item ] 1.954 + 1.955 + <td>none 1.956 + 1.957 + <td>all elements 1.958 + 1.959 + <td>no 1.960 + 1.961 + <td>N/A 1.962 + 1.963 + <td> 1.964 + 1.965 + <tr> 1.966 + <th><a class=property href="#display-inside">display-inside</a> 1.967 + 1.968 + <td>block-inside | text | table | table-inside | flex | grid 1.969 + 1.970 + <td>inline 1.971 + 1.972 + <td>all elements 1.973 + 1.974 + <td>no 1.975 + 1.976 + <td>N/A 1.977 + 1.978 + <td> 1.979 + 1.980 + <tr> 1.981 + <th><a class=property href="#display-outside">display-outside</a> 1.982 + 1.983 + <td>block | inline | table-row-group | table-header-group | 1.984 + table-footer-group | table-row | table-cell | table-column-group | 1.985 + table-column | table-caption 1.986 + 1.987 + <td>inline 1.988 + 1.989 + <td>all elements 1.990 + 1.991 + <td>no 1.992 + 1.993 + <td>N/A 1.994 + 1.995 + <td> 1.996 + 1.997 + <tr> 1.998 + <th><a class=property href="#display">display</a> 1.999 + 1.1000 + <td>inline | block | list-item | inline-block | table | inline-table | 1.1001 + table-row-group | table-header-group | table-footer-group | table-row | 1.1002 + table-column-group | table-column | table-cell | table-caption | none | 1.1003 + [ <‘display-inside’> || <‘display-outside’> || 1.1004 + <‘display-box’> || <‘display-extras’> ] 1.1005 + 1.1006 + <td>inline 1.1007 + 1.1008 + <td>all elements 1.1009 + 1.1010 + <td>no 1.1011 + 1.1012 + <td>N/A 1.1013 + 1.1014 + <td> 1.1015 + </table> 1.1016 + <!--end-properties--> 1.1017 +</html> 1.1018 +<!-- Keep this comment at the end of the file 1.1019 +Local variables: 1.1020 +mode: sgml 1.1021 +sgml-declaration:"~/SGML/HTML4.decl" 1.1022 +sgml-default-doctype-name:"html" 1.1023 +sgml-minimize-attributes:t 1.1024 +sgml-nofill-elements:("pre" "style" "br") 1.1025 +sgml-live-element-indicator:t 1.1026 +sgml-omittag:nil 1.1027 +sgml-shorttag:nil 1.1028 +sgml-namecase-general:t 1.1029 +sgml-general-insert-case:lower 1.1030 +sgml-always-quote-attributes:t 1.1031 +sgml-indent-step:nil 1.1032 +sgml-indent-data:t 1.1033 +sgml-parent-document:nil 1.1034 +sgml-exposed-tags:nil 1.1035 +sgml-local-catalogs:nil 1.1036 +sgml-local-ecat-files:nil 1.1037 +End: 1.1038 +-->
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 2.2 +++ b/css-display-3/Overview.src.html Wed Oct 17 18:44:10 2012 -0700 2.3 @@ -0,0 +1,624 @@ 2.4 +<!DOCTYPE html> 2.5 +<html lang="en"> 2.6 +<head> 2.7 + <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 2.8 + <title>CSS Display Module Level 3</title> 2.9 + <link rel=contents href="#contents"> 2.10 + <link rel=index href="#index"> 2.11 + <link rel="stylesheet" type="text/css" href="../default.css"> 2.12 + <link rel="stylesheet" type="text/css" 2.13 + href="http://www.w3.org/StyleSheets/TR/W3C-[STATUS].css"> 2.14 + <style type="text/css"> 2.15 + /* delete this block when you've cleared out all the .replaceme elements */ 2.16 + .replaceme { 2.17 + border: solid red; 2.18 + padding: 0 0.5em; 2.19 + margin: 0 0.1em; 2.20 + background: yellow; 2.21 + color: green; 2.22 + } 2.23 + .replaceme:before { 2.24 + content: "FIXME("; 2.25 + color: black; 2.26 + } 2.27 + .replaceme:after { 2.28 + content: ")"; 2.29 + color: black; 2.30 + } 2.31 + </style> 2.32 +</head> 2.33 + 2.34 +<div class="head"> 2.35 +<!--logo--> 2.36 + 2.37 +<h1>CSS Display Module Level 3</h1> 2.38 + 2.39 +<h2 class="no-num no-toc">[LONGSTATUS] [DATE]</h2> 2.40 +<dl> 2.41 + <dt>This version: 2.42 + <dd><a href="[VERSION]" class="replaceme">http://www.w3.org/TR/[YEAR]/ED-cssN-FIXME-[CDATE]/</a> 2.43 + 2.44 + <dt>Latest version: 2.45 + <dd><a href="http://www.w3.org/TR/[SHORTNAME]/">http://www.w3.org/TR/[SHORTNAME]/</a> 2.46 + 2.47 + <dt>Editor's draft: 2.48 + <dd><a href="http://dev.w3.org/csswg/[SHORTNAME]/">http://dev.w3.org/csswg/[SHORTNAME]/</a> 2.49 + 2.50 + <dt>Previous version: 2.51 + <dd><a href="http://www.w3.org/PreviousVersionURI"> 2.52 + http://www.w3.org/PreviousVersionURI</a> 2.53 + 2.54 + <dt>Issue Tracking:</dt> 2.55 + <dd><a href="http://www.w3.org/Style/CSS/Tracker/products/FIXME">http://www.w3.org/Style/CSS/Tracker/products/FIXME</a> 2.56 + 2.57 + <dt>Feedback:</dt> 2.58 + <dd><a href="http://lists.w3.org/Archives/Public/www-style/">www-style@w3.org</a> with subject line “<kbd>[[SHORTNAME]] <var>… message topic …</var></kbd>” 2.59 + 2.60 + <dt>Editors: 2.61 + <dd class="h-card vcard"> 2.62 + <a class="p-name fn u-url url" rel="author" 2.63 + href="http://www.xanthir.com/">Tab Atkins Jr.</a> 2.64 + (<span class="p-org org">Google, Inc.</span>), 2.65 + <span class="u-email email">jackalmage@gmail.com</span> 2.66 +</dl> 2.67 + 2.68 +<!--copyright--> 2.69 + 2.70 +<hr title="Separator for header"> 2.71 +</div> 2.72 + 2.73 +<h2 class="no-num no-toc" id="abstract">Abstract</h2> 2.74 + 2.75 + <p> 2.76 + This module contains the features of CSS relating to the 'display' property. 2.77 + <a href="http://www.w3.org/TR/CSS/">CSS</a> is a language for describing the rendering of structured documents 2.78 + (such as HTML and XML) 2.79 + on screen, on paper, in speech, etc. 2.80 + 2.81 +<h2 class="no-num no-toc" id="status">Status of this document</h2> 2.82 + 2.83 + <p> 2.84 + This is currently a personal draft, 2.85 + not yet approved by the CSSWG to be an Editor's Draft. 2.86 + (Ignore the branding on the side and heading, which are artifacts of the spec generation process.) 2.87 +<!--//status--> 2.88 + 2.89 +<p>The following features are at risk: … 2.90 + 2.91 +<h2 class="no-num no-toc" id="contents"> 2.92 +Table of contents</h2> 2.93 + 2.94 +<!--toc--> 2.95 + 2.96 +<h2 id="intro"> 2.97 +Introduction</h2> 2.98 + 2.99 + <p><em>This section is not normative.</em> 2.100 + 2.101 + <p> 2.102 + <var class="replaceme">Provide background, motivation, etc.</var></p> 2.103 + 2.104 +<h3 id="placement"> 2.105 +Module interactions</h3> 2.106 + 2.107 + <p class="replaceme"> 2.108 + Explain, normatively, how this module affects the definition of CSS.</p> 2.109 + 2.110 + <p> 2.111 + This module replaces and extends the <var class="replaceme">SUMMARIZE HERE</var> features defined in [[!CSS21]] sections <var class="replaceme">W.X and Y.Z</var>. 2.112 + 2.113 + <p> 2.114 + None of the properties in this module apply to the <code>::first-line</code> or <code>::first-letter</code> pseudo-elements. 2.115 + 2.116 +<h3 id="values"> 2.117 +Values</h3> 2.118 + 2.119 + <p>This specification follows the 2.120 + <a href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property 2.121 + definition conventions</a> from [[!CSS21]]. Value types not defined in 2.122 + this specification are defined in CSS Level 2 Revision 1 [[!CSS21]]. 2.123 + Other CSS modules may expand the definitions of these value types: for 2.124 + example [[CSS3COLOR]], when combined with this module, expands the 2.125 + definition of the <color> value type as used in this specification.</p> 2.126 + 2.127 + <p>In addition to the property-specific values listed in their definitions, 2.128 + all properties defined in this specification also accept the 2.129 + <a href="http://www.w3.org/TR/CSS21/cascade.html#value-def-inherit">inherit</a> 2.130 + keyword as their property value. For readability it has not been repeated 2.131 + explicitly. 2.132 + 2.133 +<h2> 2.134 +The Display Properties</h2> 2.135 + 2.136 + <p> 2.137 + ... 2.138 + 2.139 + 2.140 +<h3 id='the-display-inside'> 2.141 +Setting the layout mode: the 'display-inside' property</h3> 2.142 + 2.143 + <table class='propdef'> 2.144 + <tr> 2.145 + <th>Name: 2.146 + <td><dfn>display-inside</dfn> 2.147 + <tr> 2.148 + <th>Value: 2.149 + <td>block-inside | text | table | table-inside | flex | grid 2.150 + <tr> 2.151 + <th>Initial: 2.152 + <td>inline 2.153 + <tr> 2.154 + <th>Applies To: 2.155 + <td>all elements 2.156 + <tr> 2.157 + <th>Inherited: 2.158 + <td>no 2.159 + <tr> 2.160 + <th>Percentages: 2.161 + <td>N/A 2.162 + <tr> 2.163 + <th>Computed Value: 2.164 + <td>a keyword 2.165 + </table> 2.166 + 2.167 + <p class='issue'> 2.168 + Not super happy with the names ''block-inside'' and ''text'', 2.169 + but I need 'display-inside' and 'display-outside' to have unique sets of values. 2.170 + 2.171 + <dl> 2.172 + ... 2.173 + </dl> 2.174 + 2.175 + 2.176 +<h3 id='the-display-outside'> 2.177 +Interacting with the layout mode: the 'display-outside' property</h3> 2.178 + 2.179 + <table class='propdef'> 2.180 + <tr> 2.181 + <th>Name: 2.182 + <td><dfn>display-outside</dfn> 2.183 + <tr> 2.184 + <th>Value: 2.185 + <td>block | inline | table-row-group | table-header-group | table-footer-group | table-row | table-cell | table-column-group | table-column | table-caption 2.186 + <tr> 2.187 + <th>Initial: 2.188 + <td>inline 2.189 + <tr> 2.190 + <th>Applies To: 2.191 + <td>all elements 2.192 + <tr> 2.193 + <th>Inherited: 2.194 + <td>no 2.195 + <tr> 2.196 + <th>Percentages: 2.197 + <td>N/A 2.198 + <tr> 2.199 + <th>Computed Value: 2.200 + <td>as specified 2.201 + </table> 2.202 + 2.203 + 2.204 +<h3 id='the-display-box'> 2.205 +Controlling box generation: the 'display-box' property</h3> 2.206 + 2.207 + <table class='propdef'> 2.208 + <tr> 2.209 + <th>Name: 2.210 + <td><dfn>display-box</dfn> 2.211 + <tr> 2.212 + <th>Value: 2.213 + <td>normal | none | contents 2.214 + <tr> 2.215 + <th>Initial: 2.216 + <td>normal 2.217 + <tr> 2.218 + <th>Applies To: 2.219 + <td>all elements 2.220 + <tr> 2.221 + <th>Inherited: 2.222 + <td>no 2.223 + <tr> 2.224 + <th>Percentages: 2.225 + <td>N/A 2.226 + <tr> 2.227 + <th>Computed Value: 2.228 + <td>as specified 2.229 + </table> 2.230 + 2.231 + <dl> 2.232 + <dt><dfn id='display-box:normal'>normal</dfn> 2.233 + <dd> 2.234 + The element generates boxes as normal, 2.235 + per its other 'display-*' properties. 2.236 + 2.237 + <dt><dfn id='display-box:none'>none</dfn> 2.238 + <dd> 2.239 + The element generates no boxes at all. 2.240 + 2.241 + <dt><dfn id='display-box:contents'>contents</dfn> 2.242 + <dd> 2.243 + The element itself does not generate any boxes, 2.244 + but its children and pseudo-elements still generate boxes as normal, 2.245 + as if the set of children and psuedo-elements completely replaced the element itself in the document. 2.246 + </dl> 2.247 + 2.248 + <p class='issue'> 2.249 + Is there a need for a value that suppresses box generation for layout purposes, 2.250 + but still generates them for the purposes of animations/counters/etc.? 2.251 + 2.252 + 2.253 + 2.254 +<h3 id='the-display-extras'> 2.255 +Additional stuff: the 'display-extras' property</h3> 2.256 + 2.257 + <table class='propdef'> 2.258 + <tr> 2.259 + <th>Name: 2.260 + <td><dfn>display-extras</dfn> 2.261 + <tr> 2.262 + <th>Value: 2.263 + <td>none | [ list-item ] 2.264 + <tr> 2.265 + <th>Initial: 2.266 + <td>none 2.267 + <tr> 2.268 + <th>Applies To: 2.269 + <td>all elements 2.270 + <tr> 2.271 + <th>Inherited: 2.272 + <td>no 2.273 + <tr> 2.274 + <th>Percentages: 2.275 + <td>N/A 2.276 + <tr> 2.277 + <th>Computed Value: 2.278 + <td>as specified 2.279 + </table> 2.280 + 2.281 + <dl> 2.282 + <dt><dfn id='display-extras:list-item'>list-item</dfn> 2.283 + <dd> 2.284 + The element generates a <code>::marker</code> pseudo-element 2.285 + and is considered a <a href="../css3-lists/#list-item">list item</a>. 2.286 + </dl> 2.287 + 2.288 +<h3 id='the-display'> 2.289 +The 'display' shorthand property</h3> 2.290 + 2.291 + <table class='propdef'> 2.292 + <tr> 2.293 + <th>Name: 2.294 + <td><dfn>display</dfn> 2.295 + <tr> 2.296 + <th>Value: 2.297 + <td>inline | block | list-item | inline-block | table | inline-table | table-row-group | table-header-group | table-footer-group | table-row | table-column-group | table-column | table-cell | table-caption | none | [ <'display-inside'> || <'display-outside'> || <'display-box'> || <'display-extras'> ] 2.298 + <tr> 2.299 + <th>Initial: 2.300 + <td>inline 2.301 + <tr> 2.302 + <th>Applies To: 2.303 + <td>all elements 2.304 + <tr> 2.305 + <th>Inherited: 2.306 + <td>no 2.307 + <tr> 2.308 + <th>Percentages: 2.309 + <td>N/A 2.310 + <tr> 2.311 + <th>Computed Value: 2.312 + <td>N/A 2.313 + </table> 2.314 + 2.315 + <p> 2.316 + The single-keyword values listed explicitly in the grammar above are handled specially, 2.317 + for legacy reasons. 2.318 + All other single-keyword values, 2.319 + and all other values in general, 2.320 + are handled as normal for shorthands. 2.321 + 2.322 + <dl> 2.323 + <dt><dfn id='display:inline'>inline</dfn> 2.324 + <dd> 2.325 + Expands identically to ''inline text''. 2.326 + 2.327 + <dt><dfn id='display:block'>block</dfn> 2.328 + <dd> 2.329 + Expands identically to ''block block-inside''. 2.330 + 2.331 + <dt><dfn id='display:list-item'>list-item</dfn> 2.332 + <dd> 2.333 + Expands identically to ''block block-inside list-item''. 2.334 + 2.335 + <dt><dfn id='display:inline-block'>inline-block</dfn> 2.336 + <dd> 2.337 + Expands identically to ''inline block-inside''. 2.338 + 2.339 + <dt><dfn id='display:table'>table</dfn> 2.340 + <dd> 2.341 + Expands identically to ''block table''. 2.342 + 2.343 + <dt><dfn id='display:inline-table'>inline-table</dfn> 2.344 + <dd> 2.345 + Expands identically to ''inline table''. 2.346 + 2.347 + <dt><dfn id='display:table-row-group'>table-row-group</dfn>, <dfn id='display:table-header-group'>table-header-group</dfn>, <dfn id='display:table-footer-group'>table-footer-group</dfn>, <dfn id='display:table-row'>table-row</dfn>, <dfn id='display:table-column-group'>table-column-group</dfn>, <dfn id='display:table-column'>table-column</dfn> 2.348 + <dd> 2.349 + Expands identically to ''[the value] table-inside''. 2.350 + 2.351 + <dt><dfn id='display:table-caption'>table-caption</dfn> 2.352 + <dd> 2.353 + Expands identically to ''table-caption block-inside''. 2.354 + 2.355 + <dt><dfn id='display:table-cell'>table-cell</dfn> 2.356 + <dd> 2.357 + Expands identically to ''table-cell block-inside''. 2.358 + 2.359 + <dt><dfn id='display:none'>none</dfn> 2.360 + <dd> 2.361 + Expands identically to ''inline text none''. 2.362 + </dl> 2.363 + 2.364 + 2.365 + 2.366 + 2.367 +<!-- 2.368 + 2.369 +TTTTTTTTTTTTTTTTTTTTTTTHHHHHHHHH HHHHHHHHHEEEEEEEEEEEEEEEEEEEEEE 2.370 +T:::::::::::::::::::::TH:::::::H H:::::::HE::::::::::::::::::::E 2.371 +T:::::::::::::::::::::TH:::::::H H:::::::HE::::::::::::::::::::E 2.372 +T:::::TT:::::::TT:::::THH::::::H H::::::HHEE::::::EEEEEEEEE::::E 2.373 +TTTTTT T:::::T TTTTTT H:::::H H:::::H E:::::E EEEEEE 2.374 + T:::::T H:::::H H:::::H E:::::E 2.375 + T:::::T H::::::HHHHH::::::H E::::::EEEEEEEEEE 2.376 + T:::::T H:::::::::::::::::H E:::::::::::::::E 2.377 + T:::::T H:::::::::::::::::H E:::::::::::::::E 2.378 + T:::::T H::::::HHHHH::::::H E::::::EEEEEEEEEE 2.379 + T:::::T H:::::H H:::::H E:::::E 2.380 + T:::::T H:::::H H:::::H E:::::E EEEEEE 2.381 + TT:::::::TT HH::::::H H::::::HHEE::::::EEEEEEEE:::::E 2.382 + T:::::::::T H:::::::H H:::::::HE::::::::::::::::::::E 2.383 + T:::::::::T H:::::::H H:::::::HE::::::::::::::::::::E 2.384 + TTTTTTTTTTT HHHHHHHHH HHHHHHHHHEEEEEEEEEEEEEEEEEEEEEE 2.385 + 2.386 + 2.387 + 2.388 +EEEEEEEEEEEEEEEEEEEEEENNNNNNNN NNNNNNNNDDDDDDDDDDDDD 2.389 +E::::::::::::::::::::EN:::::::N N::::::ND::::::::::::DDD 2.390 +E::::::::::::::::::::EN::::::::N N::::::ND:::::::::::::::DD 2.391 +EE::::::EEEEEEEEE::::EN:::::::::N N::::::NDDD:::::DDDDD:::::D 2.392 + E:::::E EEEEEEN::::::::::N N::::::N D:::::D D:::::D 2.393 + E:::::E N:::::::::::N N::::::N D:::::D D:::::D 2.394 + E::::::EEEEEEEEEE N:::::::N::::N N::::::N D:::::D D:::::D 2.395 + E:::::::::::::::E N::::::N N::::N N::::::N D:::::D D:::::D 2.396 + E:::::::::::::::E N::::::N N::::N:::::::N D:::::D D:::::D 2.397 + E::::::EEEEEEEEEE N::::::N N:::::::::::N D:::::D D:::::D 2.398 + E:::::E N::::::N N::::::::::N D:::::D D:::::D 2.399 + E:::::E EEEEEEN::::::N N:::::::::N D:::::D D:::::D 2.400 +EE::::::EEEEEEEE:::::EN::::::N N::::::::NDDD:::::DDDDD:::::D 2.401 +E::::::::::::::::::::EN::::::N N:::::::ND:::::::::::::::DD 2.402 +E::::::::::::::::::::EN::::::N N::::::ND::::::::::::DDD 2.403 +EEEEEEEEEEEEEEEEEEEEEENNNNNNNN NNNNNNNDDDDDDDDDDDDD 2.404 +--> 2.405 + 2.406 +<h2 id="conformance"> 2.407 +Conformance</h2> 2.408 + 2.409 +<h3 id="conventions"> 2.410 +Document conventions</h3> 2.411 + 2.412 + <p>Conformance requirements are expressed with a combination of 2.413 + descriptive assertions and RFC 2119 terminology. The key words “MUST”, 2.414 + “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, 2.415 + “RECOMMENDED”, “MAY”, and “OPTIONAL” in the normative parts of this 2.416 + document are to be interpreted as described in RFC 2119. 2.417 + However, for readability, these words do not appear in all uppercase 2.418 + letters in this specification. 2.419 + 2.420 + <p>All of the text of this specification is normative except sections 2.421 + explicitly marked as non-normative, examples, and notes. [[!RFC2119]]</p> 2.422 + 2.423 + <p>Examples in this specification are introduced with the words “for example” 2.424 + or are set apart from the normative text with <code>class="example"</code>, 2.425 + like this: 2.426 + 2.427 + <div class="example"> 2.428 + <p>This is an example of an informative example.</p> 2.429 + </div> 2.430 + 2.431 + <p>Informative notes begin with the word “Note” and are set apart from the 2.432 + normative text with <code>class="note"</code>, like this: 2.433 + 2.434 + <p class="note">Note, this is an informative note.</p> 2.435 + 2.436 +<h3 id="conformance-classes"> 2.437 +Conformance classes</h3> 2.438 + 2.439 + <p>Conformance to <var class="replaceme">CSS TEMPLATE Module</var> 2.440 + is defined for three conformance classes: 2.441 + <dl> 2.442 + <dt><dfn title="style sheet!!as conformance class">style sheet</dfn> 2.443 + <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#style-sheet">CSS 2.444 + style sheet</a>. 2.445 + <dt><dfn>renderer</dfn></dt> 2.446 + <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> 2.447 + that interprets the semantics of a style sheet and renders 2.448 + documents that use them. 2.449 + <dt><dfn id="authoring-tool">authoring tool</dfn></dt> 2.450 + <dd>A <a href="http://www.w3.org/TR/CSS21/conform.html#user-agent">UA</a> 2.451 + that writes a style sheet. 2.452 + </dl> 2.453 + 2.454 + <p>A style sheet is conformant to <var class="replaceme">CSS TEMPLATE Module</var> 2.455 + if all of its statements that use syntax defined in this module are valid 2.456 + according to the generic CSS grammar and the individual grammars of each 2.457 + feature defined in this module. 2.458 + 2.459 + <p>A renderer is conformant to <var class="replaceme">CSS TEMPLATE Module</var> 2.460 + if, in addition to interpreting the style sheet as defined by the 2.461 + appropriate specifications, it supports all the features defined 2.462 + by <var class="replaceme">CSS TEMPLATE Module</var> by parsing them correctly 2.463 + and rendering the document accordingly. However, the inability of a 2.464 + UA to correctly render a document due to limitations of the device 2.465 + does not make the UA non-conformant. (For example, a UA is not 2.466 + required to render color on a monochrome monitor.) 2.467 + 2.468 + <p>An authoring tool is conformant to <var class="replaceme">CSS TEMPLATE Module</var> 2.469 + if it writes style sheets that are syntactically correct according to the 2.470 + generic CSS grammar and the individual grammars of each feature in 2.471 + this module, and meet all other conformance requirements of style sheets 2.472 + as described in this module. 2.473 + 2.474 +<h3 id="partial"> 2.475 +Partial implementations</h3> 2.476 + 2.477 + <p>So that authors can exploit the forward-compatible parsing rules to 2.478 + assign fallback values, CSS renderers <strong>must</strong> 2.479 + treat as invalid (and <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignore 2.480 + as appropriate</a>) any at-rules, properties, property values, keywords, 2.481 + and other syntactic constructs for which they have no usable level of 2.482 + support. In particular, user agents <strong>must not</strong> selectively 2.483 + ignore unsupported component values and honor supported values in a single 2.484 + multi-value property declaration: if any value is considered invalid 2.485 + (as unsupported values must be), CSS requires that the entire declaration 2.486 + be ignored.</p> 2.487 + 2.488 +<h3 id="experimental"> 2.489 +Experimental implementations</h3> 2.490 + 2.491 + <p>To avoid clashes with future CSS features, the CSS2.1 specification 2.492 + reserves a <a href="http://www.w3.org/TR/CSS21/syndata.html#vendor-keywords">prefixed 2.493 + syntax</a> for proprietary and experimental extensions to CSS. 2.494 + 2.495 + <p>Prior to a specification reaching the Candidate Recommendation stage 2.496 + in the W3C process, all implementations of a CSS feature are considered 2.497 + experimental. The CSS Working Group recommends that implementations 2.498 + use a vendor-prefixed syntax for such features, including those in 2.499 + W3C Working Drafts. This avoids incompatibilities with future changes 2.500 + in the draft. 2.501 + </p> 2.502 + 2.503 +<h3 id="testing"> 2.504 +Non-experimental implementations</h3> 2.505 + 2.506 + <p>Once a specification reaches the Candidate Recommendation stage, 2.507 + non-experimental implementations are possible, and implementors should 2.508 + release an unprefixed implementation of any CR-level feature they 2.509 + can demonstrate to be correctly implemented according to spec. 2.510 + 2.511 + <p>To establish and maintain the interoperability of CSS across 2.512 + implementations, the CSS Working Group requests that non-experimental 2.513 + CSS renderers submit an implementation report (and, if necessary, the 2.514 + testcases used for that implementation report) to the W3C before 2.515 + releasing an unprefixed implementation of any CSS features. Testcases 2.516 + submitted to W3C are subject to review and correction by the CSS 2.517 + Working Group. 2.518 + 2.519 + <p>Further information on submitting testcases and implementation reports 2.520 + can be found from on the CSS Working Group's website at 2.521 + <a href="http://www.w3.org/Style/CSS/Test/">http://www.w3.org/Style/CSS/Test/</a>. 2.522 + Questions should be directed to the 2.523 + <a href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a> 2.524 + mailing list. 2.525 + 2.526 +<h3 id="cr-exit-criteria"> 2.527 +CR exit criteria</h3> 2.528 + 2.529 + <p class="replaceme">Remove this section unless/until the module is in CR.</p> 2.530 + 2.531 + <!-- This text was <a href="http://www.w3.org/Style/CSS/Tracker/actions/44"> decided on 2008-06-04.</a> --> 2.532 + 2.533 + <p> 2.534 + For this specification to be advanced to Proposed Recommendation, 2.535 + there must be at least two independent, interoperable implementations 2.536 + of each feature. Each feature may be implemented by a different set of 2.537 + products, there is no requirement that all features be implemented by 2.538 + a single product. For the purposes of this criterion, we define the 2.539 + following terms: 2.540 + 2.541 + <dl> 2.542 + <dt>independent <dd>each implementation must be developed by a 2.543 + different party and cannot share, reuse, or derive from code 2.544 + used by another qualifying implementation. Sections of code that 2.545 + have no bearing on the implementation of this specification are 2.546 + exempt from this requirement. 2.547 + 2.548 + <dt>interoperable <dd>passing the respective test case(s) in the 2.549 + official CSS test suite, or, if the implementation is not a Web 2.550 + browser, an equivalent test. Every relevant test in the test 2.551 + suite should have an equivalent test created if such a user 2.552 + agent (UA) is to be used to claim interoperability. In addition 2.553 + if such a UA is to be used to claim interoperability, then there 2.554 + must one or more additional UAs which can also pass those 2.555 + equivalent tests in the same way for the purpose of 2.556 + interoperability. The equivalent tests must be made publicly 2.557 + available for the purposes of peer review. 2.558 + 2.559 + <dt>implementation <dd>a user agent which: 2.560 + 2.561 + <ol class=inline> 2.562 + <li>implements the specification. 2.563 + 2.564 + <li>is available to the general public. The implementation may 2.565 + be a shipping product or other publicly available version 2.566 + (i.e., beta version, preview release, or “nightly build”). 2.567 + Non-shipping product releases must have implemented the 2.568 + feature(s) for a period of at least one month in order to 2.569 + demonstrate stability. 2.570 + 2.571 + <li>is not experimental (i.e., a version specifically designed 2.572 + to pass the test suite and is not intended for normal usage 2.573 + going forward). 2.574 + </ol> 2.575 + </dl> 2.576 + 2.577 + <p>The specification will remain Candidate Recommendation for at least 2.578 + six months. 2.579 + 2.580 +<h2 class=no-num id="acknowledgments"> 2.581 +Acknowledgments</h2> 2.582 + 2.583 + <p><var class="replaceme">[acknowledgments]</var></p> 2.584 + 2.585 +<h2 class=no-num id="references"> 2.586 +References</h2> 2.587 + 2.588 +<h3 class="no-num" id="normative-references"> 2.589 +Normative references</h3> 2.590 +<!--normative--> 2.591 + 2.592 +<h3 class="no-num" id="other-references"> 2.593 +Other references</h3> 2.594 +<!--informative--> 2.595 + 2.596 +<h2 class="no-num" id="index"> 2.597 +Index</h2> 2.598 +<!--index--> 2.599 + 2.600 +<h2 class="no-num" id="property-index"> 2.601 +Property index</h2> 2.602 +<!-- properties --> 2.603 + 2.604 +</body> 2.605 +</html> 2.606 +<!-- Keep this comment at the end of the file 2.607 +Local variables: 2.608 +mode: sgml 2.609 +sgml-declaration:"~/SGML/HTML4.decl" 2.610 +sgml-default-doctype-name:"html" 2.611 +sgml-minimize-attributes:t 2.612 +sgml-nofill-elements:("pre" "style" "br") 2.613 +sgml-live-element-indicator:t 2.614 +sgml-omittag:nil 2.615 +sgml-shorttag:nil 2.616 +sgml-namecase-general:t 2.617 +sgml-general-insert-case:lower 2.618 +sgml-always-quote-attributes:t 2.619 +sgml-indent-step:nil 2.620 +sgml-indent-data:t 2.621 +sgml-parent-document:nil 2.622 +sgml-exposed-tags:nil 2.623 +sgml-local-catalogs:nil 2.624 +sgml-local-ecat-files:nil 2.625 +End: 2.626 +--> 2.627 +