[css-display-3] First commit of the display module.

Wed, 17 Oct 2012 18:44:10 -0700

author
Tab Atkins Jr. <jackalmage@gmail.com>
date
Wed, 17 Oct 2012 18:44:10 -0700
changeset 6878
03dc74c629ad
parent 6877
d7ffef805337
child 6879
f81d11644ac1

[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 +   &lt;color&gt; 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 +      [ &lt;‘<a href="#display-inside"><code
   1.475 +      class=property>display-inside</code></a>’> || &lt;‘<a
   1.476 +      href="#display-outside"><code
   1.477 +      class=property>display-outside</code></a>’> || &lt;‘<a
   1.478 +      href="#display-box"><code class=property>display-box</code></a>’> ||
   1.479 +      &lt;‘<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 +      [ &lt;‘display-inside’> || &lt;‘display-outside’> ||
  1.1004 +      &lt;‘display-box’> || &lt;‘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 &ldquo;<kbd>[[SHORTNAME]] <var>&hellip; message topic &hellip;</var></kbd>&rdquo;
    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: &hellip;
    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 &lt;color&gt; 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 | [ &lt;'display-inside'> || &lt;'display-outside'> || &lt;'display-box'> || &lt;'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 + 

mercurial