Mon, 12 Mar 2012 09:55:58 -0700
generated
css3-flexbox/Overview.html | file | annotate | diff | comparison | revisions |
1.1 --- a/css3-flexbox/Overview.html Mon Mar 12 09:53:28 2012 -0700 1.2 +++ b/css3-flexbox/Overview.html Mon Mar 12 09:55:58 2012 -0700 1.3 @@ -240,24 +240,26 @@ 1.4 <li><a href="#pagination"><span class=secno>10. </span> Page breaks in 1.5 flexbox</a> 1.6 1.7 - <li><a href="#conformance"><span class=secno>11. </span> Conformance</a> 1.8 + <li><a href="#cssom"><span class=secno>11. </span>CSSOM</a> 1.9 + 1.10 + <li><a href="#conformance"><span class=secno>12. </span> Conformance</a> 1.11 <ul class=toc> 1.12 - <li><a href="#conventions"><span class=secno>11.1. </span> Document 1.13 + <li><a href="#conventions"><span class=secno>12.1. </span> Document 1.14 conventions</a> 1.15 1.16 - <li><a href="#conformance-classes"><span class=secno>11.2. </span> 1.17 + <li><a href="#conformance-classes"><span class=secno>12.2. </span> 1.18 Conformance classes</a> 1.19 1.20 - <li><a href="#partial"><span class=secno>11.3. </span> Partial 1.21 + <li><a href="#partial"><span class=secno>12.3. </span> Partial 1.22 implementations</a> 1.23 1.24 - <li><a href="#experimental"><span class=secno>11.4. </span> Experimental 1.25 + <li><a href="#experimental"><span class=secno>12.4. </span> Experimental 1.26 implementations</a> 1.27 1.28 - <li><a href="#testing"><span class=secno>11.5. </span> Non-experimental 1.29 + <li><a href="#testing"><span class=secno>12.5. </span> Non-experimental 1.30 implementations</a> 1.31 1.32 - <li><a href="#cr-exit-criteria"><span class=secno>11.6. </span> CR exit 1.33 + <li><a href="#cr-exit-criteria"><span class=secno>12.6. </span> CR exit 1.34 criteria</a> 1.35 </ul> 1.36 1.37 @@ -2333,9 +2335,31 @@ 1.38 </ol> 1.39 </ul> 1.40 1.41 - <h2 id=conformance><span class=secno>11. </span> Conformance</h2> 1.42 - 1.43 - <h3 id=conventions><span class=secno>11.1. </span> Document conventions</h3> 1.44 + <h2 id=cssom><span class=secno>11. </span>CSSOM</h2> 1.45 + 1.46 + <div class=issue> 1.47 + <p>'Flex' property is currently defined as shorthand only, 1.48 + combining three values. When queried from OM, it is seen as a 1.49 + string with up to three values, which can be very complicated to deal 1.50 + with properly.</p> 1.51 + 1.52 + <p>There should be separate properties to access flexibility components in 1.53 + OM, such as:</p> 1.54 + 1.55 + <pre class=idl> 1.56 +[Supplemental] interface "<a 1.57 + href="http://www.w3.org/TR/cssom/#cssstyledeclaration">CSSStyleDeclaration</a> { 1.58 + attribute DOMString? flexPositive; 1.59 + attribute DOMString? flexNegative; 1.60 + attribute DOMString? flexPreferredSize; 1.61 +}; 1.62 +</pre> 1.63 + See <a 1.64 + href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16145">Bug-16145</a></div> 1.65 + 1.66 + <h2 id=conformance><span class=secno>12. </span> Conformance</h2> 1.67 + 1.68 + <h3 id=conventions><span class=secno>12.1. </span> Document conventions</h3> 1.69 1.70 <p>Conformance requirements are expressed with a combination of descriptive 1.71 assertions and RFC 2119 terminology. The key words “MUST”, “MUST 1.72 @@ -2362,7 +2386,7 @@ 1.73 1.74 <p class=note>Note, this is an informative note. 1.75 1.76 - <h3 id=conformance-classes><span class=secno>11.2. </span> Conformance 1.77 + <h3 id=conformance-classes><span class=secno>12.2. </span> Conformance 1.78 classes</h3> 1.79 1.80 <p>Conformance to CSS Flexbox Layout Module is defined for three 1.81 @@ -2406,7 +2430,7 @@ 1.82 module, and meet all other conformance requirements of style sheets as 1.83 described in this module. 1.84 1.85 - <h3 id=partial><span class=secno>11.3. </span> Partial implementations</h3> 1.86 + <h3 id=partial><span class=secno>12.3. </span> Partial implementations</h3> 1.87 1.88 <p>So that authors can exploit the forward-compatible parsing rules to 1.89 assign fallback values, CSS renderers <strong>must</strong> treat as 1.90 @@ -2420,7 +2444,7 @@ 1.91 unsupported values must be), CSS requires that the entire declaration be 1.92 ignored. 1.93 1.94 - <h3 id=experimental><span class=secno>11.4. </span> Experimental 1.95 + <h3 id=experimental><span class=secno>12.4. </span> Experimental 1.96 implementations</h3> 1.97 1.98 <p>To avoid clashes with future CSS features, the CSS2.1 specification 1.99 @@ -2434,7 +2458,7 @@ 1.100 vendor-prefixed syntax for such features, including those in W3C Working 1.101 Drafts. This avoids incompatibilities with future changes in the draft. 1.102 1.103 - <h3 id=testing><span class=secno>11.5. </span> Non-experimental 1.104 + <h3 id=testing><span class=secno>12.5. </span> Non-experimental 1.105 implementations</h3> 1.106 1.107 <p>Once a specification reaches the Candidate Recommendation stage, 1.108 @@ -2456,7 +2480,7 @@ 1.109 href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a> 1.110 mailing list. 1.111 1.112 - <h3 id=cr-exit-criteria><span class=secno>11.6. </span> CR exit criteria</h3> 1.113 + <h3 id=cr-exit-criteria><span class=secno>12.6. </span> CR exit criteria</h3> 1.114 1.115 <p> For this specification to be advanced to Proposed Recommendation, there 1.116 must be at least two independent, interoperable implementations of each 1.117 @@ -2744,7 +2768,7 @@ 1.118 1.119 <ul class=indexlist> 1.120 <li>authoring tool, <a href="#authoring-tool" 1.121 - title="authoring tool"><strong>11.2.</strong></a> 1.122 + title="authoring tool"><strong>12.2.</strong></a> 1.123 1.124 <li>’auto'‘<code class=css>, <a href="#flex-item-align-auto" 1.125 title="</code>’‘<code class=property>auto</code>’‘<code class=css>"><strong>8.2.</strong></a> 1.126 @@ -2890,7 +2914,7 @@ 1.127 title="preferred size"><strong>7.</strong></a> 1.128 1.129 <li>renderer, <a href="#renderer" 1.130 - title=renderer><strong>11.2.</strong></a> 1.131 + title=renderer><strong>12.2.</strong></a> 1.132 1.133 <li>resolve the flexible lengths, <a href="#resolve-the-flexible-lengths" 1.134 title="resolve the flexible lengths"><strong>9.</strong></a> 1.135 @@ -2915,7 +2939,7 @@ 1.136 <li>style sheet 1.137 <ul> 1.138 <li>as conformance class, <a href="#style-sheet" 1.139 - title="style sheet, as conformance class"><strong>11.2.</strong></a> 1.140 + title="style sheet, as conformance class"><strong>12.2.</strong></a> 1.141 </ul> 1.142 1.143 <li>wrap, <a href="#flex-flow-wrap" title=wrap><strong>6.2.</strong></a>