[css-grid] Per task force discussion, keep getComputedStyle() returning used values for grid-template-rows/columns, and re-add 'grid-auto-flow:none'.

Author: tabatkins

css-grid/Overview.html

@@ -1191,11 +1191,13 @@ <h4 data-level=5.1.5 id=resolved-track-list><span class=secno>5.1.5 </span><span
   // (a) 50px (b) 320px (b c d) repeat(2, (e) 40px) repeat(4, 0px) 50px
 &lt;/script&gt;</pre>	</div>
 
-	<p class=issue>
-		In general, resolved values are the computed values,
-		except for a small list of legacy 2.1 properties.
-		Do we really want these properties to return the used value here?
-		<a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16906">Bug about this.</a>
+<p class=note>	Note: In general, resolved values are the computed values,
+	except for a small list of legacy 2.1 properties.
+	However, compatibility with early implementations of this module
+	requires us to define <a class=property data-link-type=propdesc href=#propdef-grid-template-rows title=grid-template-rows>grid-template-rows</a> and <a class=property data-link-type=propdesc href=#propdef-grid-template-columns title=grid-template-columns>grid-template-columns</a> as returning used values.
+	Authors are recommended to use the 
+	<a href=http://dev.w3.org/csswg/cssom/#the-getstyleutils-interface><code>.rawComputedStyle</code> and <code>.usedStyle</code> attributes</a>
+	instead of <code>getComputedStyle()</code>.
 
 
 <h3 data-level=5.2 id=grid-template-areas-property><span class=secno>5.2 </span><span class=content>
@@ -1298,7 +1300,7 @@ <h3 data-level=5.3 id=explicit-grid-shorthand><span class=secno>5.3 </span><span
 		It has three distinct syntax forms:
 
 	<dl data-dfn-for=grid-template data-dfn-type=value>
-		<dt><dfn data-dfn-for=grid-template data-dfn-type=value data-export="" id=valuedef-none>none</dfn>
+		<dt><dfn data-dfn-for=grid-template data-dfn-type=value data-export="" id=valuedef-none2>none</dfn>
 		<dd>
 			Sets all three properties to their initial values (<a data-link-for=grid-template-rows data-link-type=value href=#valuedef-none0>none</a>).
 
@@ -1418,13 +1420,18 @@ <h3 data-level=6.1 id=auto-tracks><span class=secno>6.1 </span><span class=conte
 <h3 data-level=6.2 id=grid-auto-flow-property><span class=secno>6.2 </span><span class=content>
 Automatic Placement: the <a class=property data-link-type=propdesc href=#propdef-grid-auto-flow title=grid-auto-flow>grid-auto-flow</a> property</span><a class=section-link href=#grid-auto-flow-property>§</a></h3>
 
-<table class=propdef><tr><th>Name:<td><dfn data-dfn-type=property data-export="" id=propdef-grid-auto-flow>grid-auto-flow</dfn><tr><th>Value:<td>[ rows | columns ] &amp;&amp; dense?<tr><th>Initial:<td>rows<tr><th>Applies to:<td><a href=#grid-container>grid containers</a><tr><th>Inherited:<td>no<tr><th>Percentages:<td>n/a<tr><th>Media:<td>visual<tr><th>Computed value:<td>specified value</table>
+<table class=propdef><tr><th>Name:<td><dfn data-dfn-type=property data-export="" id=propdef-grid-auto-flow>grid-auto-flow</dfn><tr><th>Value:<td>none | [ [ rows | columns ] &amp;&amp; dense? ]<tr><th>Initial:<td>rows<tr><th>Applies to:<td><a href=#grid-container>grid containers</a><tr><th>Inherited:<td>no<tr><th>Percentages:<td>n/a<tr><th>Media:<td>visual<tr><th>Computed value:<td>specified value</table>
 	<p>
 		<a href=#grid-item>Grid items</a> that aren't explicitly placed are are automatically placed into an unoccupied space in the <a href=#grid-container>grid container</a>.
 		The <a class=property data-link-type=propdesc href=#propdef-grid-auto-flow title=grid-auto-flow>grid-auto-flow</a> property controls the direction in which the search for unoccupied space takes place, 
 		and whether rows or columns are added as needed to accommodate the content.
 
 	<dl data-dfn-for=grid-auto-flow data-dfn-type=value>
+		<dt><dfn data-dfn-for=grid-auto-flow data-dfn-type=value data-export="" id=valuedef-none>none</dfn>
+		<dd>
+			Rather than use the auto-placement algorithm,
+			auto-placed <a href=#grid-item>grid items</a> are simply positioned according to the <a class=property data-link-type=propdesc title=grid-auto-position>grid-auto-position</a> property.
+
 		<dt><dfn data-dfn-for=grid-auto-flow data-dfn-type=value data-export="" id=valuedef-rows>rows</dfn>
 		<dd>
 			The auto-placement algorithm places items
@@ -1447,11 +1454,7 @@ <h3 data-level=6.2 id=grid-auto-flow-property><span class=secno>6.2 </span><span
 <p class=note>			Note: This may cause items to appear out-of-order.
 	</dl>
 
-	<p class=issue>
-		Add a value for stacking items on top of each other?
-
-	<p class=issue>
-		Add a value for flowing items together into a single slot?
+<p class=note>	Note: A future level of this module is expected to add a value that flows auto-positioned items together into a single “default” cell.
 
 	<p>
 		Auto-placement takes <a href=#grid-item>grid items</a> in <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-flexbox-1/#order title=order>order</a>-modified document order.
@@ -2768,7 +2771,8 @@ <h2 class="no-num no-ref" id=index><span class=content>
 <li>named line, <a href=#named-lines0 title="section 5.1.1">5.1.1</a>
 <li>none (value), <a href=#valuedef-none0 title="section 5.1">5.1</a>
 <li>none (value), <a href=#valuedef-none1 title="section 5.2">5.2</a>
-<li>none (value), <a href=#valuedef-none title="section 5.3">5.3</a>
+<li>none (value), <a href=#valuedef-none2 title="section 5.3">5.3</a>
+<li>none (value), <a href=#valuedef-none title="section 6.2">6.2</a>
 <li>order-modified grid order, <a href=#order-modified-grid-order title="section 9.5">9.5</a>
 <li>participates in baseline alignment, <a href=#baseline-participation title="section 9.5">9.5</a>
 <li>&lt;percentage&gt; (value), <a href=#valuedef-percentage title="section 5.1">5.1</a>
@@ -2802,7 +2806,7 @@ <h2 class="no-num no-ref" id=property-index><span class=content>
 <tr><th scope=row><a data-property="">grid-template</a><td>none | <a class=production data-link-type=propdesc href=#propdef-grid-template-columns title=grid-template-columns>&lt;‘grid-template-columns’&gt;</a> / <a class=production data-link-type=propdesc href=#propdef-grid-template-rows title=grid-template-rows>&lt;‘grid-template-rows’&gt;</a> |<br> [ <a class=production data-link-type=type href=#typedef-track-list>&lt;track-list&gt;</a> / ]? [ <a class=production data-link-type=type href=#typedef-line-names>&lt;line-names&gt;</a>? <a class=production data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#string-value>&lt;string&gt;</a> [ <a class=production data-link-type=type href=#typedef-track-size>&lt;track-size&gt;</a> <a class=production data-link-type=type href=#typedef-line-names>&lt;line-names&gt;</a> ]? ]+<td>see individual properties<td><td>see individual properties<td>see individual properties<td>visual<td><a href=#grid-container>grid containers</a><td>see individual properties<td>
 <tr><th scope=row><a data-property="">grid-auto-columns</a><td><a class=production data-link-type=type href=#typedef-track-size>&lt;track-size&gt;</a><td>auto<td><td>no<td>see <a href=#track-sizing>Track Sizing</a><td>visual<td><a href=#grid-container>grid containers</a><td>see <a href=#track-sizing>Track Sizing</a><td>
 <tr><th scope=row><a data-property="">grid-auto-rows</a><td><a class=production data-link-type=type href=#typedef-track-size>&lt;track-size&gt;</a><td>auto<td><td>no<td>see <a href=#track-sizing>Track Sizing</a><td>visual<td><a href=#grid-container>grid containers</a><td>see <a href=#track-sizing>Track Sizing</a><td>
-<tr><th scope=row><a data-property="">grid-auto-flow</a><td>[ rows | columns ] &amp;&amp; dense?<td>rows<td><td>no<td>n/a<td>visual<td><a href=#grid-container>grid containers</a><td>specified value<td>
+<tr><th scope=row><a data-property="">grid-auto-flow</a><td>none | [ [ rows | columns ] &amp;&amp; dense? ]<td>rows<td><td>no<td>n/a<td>visual<td><a href=#grid-container>grid containers</a><td>specified value<td>
 <tr><th scope=row><a data-property="">grid-auto</a><td><a class=production data-link-type=propdesc href=#propdef-grid-auto-flow title=grid-auto-flow>&lt;‘grid-auto-flow’&gt;</a> || [ <a class=production data-link-type=propdesc href=#propdef-grid-auto-columns title=grid-auto-columns>&lt;‘grid-auto-columns’&gt;</a> [ / <a class=production data-link-type=propdesc href=#propdef-grid-auto-rows title=grid-auto-rows>&lt;‘grid-auto-rows’&gt;</a> ]? ]<td>see individual properties<td><td>see individual properties<td>see individual properties<td>visual<td><a href=#grid-container>grid containers</a><td>see individual properties<td>
 <tr><th scope=row><a data-property="">grid-row-start</a><td><a class=production data-link-type=type href=#typedef-grid-line>&lt;grid-line&gt;</a><td>auto<td><td>no<td>n/a<td>visual<td><a href=#grid-item>grid items</a><td>specified value (almost)<td>
 <tr><th scope=row><a data-property="">grid-column-start</a><td><a class=production data-link-type=type href=#typedef-grid-line>&lt;grid-line&gt;</a><td>auto<td><td>no<td>n/a<td>visual<td><a href=#grid-item>grid items</a><td>specified value (almost)<td>

css-grid/Overview.src.html

@@ -15,7 +15,7 @@ <h1>CSS Grid Layout Module Level 1</h1>
 Previous editors: <a href="mailto:pcupp@microsoft.com">Phil Cupp</a>, Microsoft Corporation
 Issues list: <a href="https://www.w3.org/Bugs/Public/buglist.cgi?product=CSS&amp;component=Grid+Layout&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED">In Bugzilla</a>
 Abstract: This CSS module defines a two-dimensional grid-based layout system, optimized for user interface design. In the grid layout model, the children of a grid container can be positioned into arbitrary slots in a flexible or fixed predefined layout grid.
-Ignored Terms: column-*, justify-*, containing block, grid-field, <positive-integer>, <ident>, auto
+Ignored Terms: column-*, justify-*, containing block, grid-field, <positive-integer>, <ident>, auto, grid-auto-position
 Link Defaults: css21 (property) margin, css-align-3 (dfn) alignment container/alignment subject
 </pre>
 
@@ -1130,11 +1130,13 @@ <h4 id='resolved-track-list'>
 &lt;/script></pre>
 	</div>
 
-	<p class='issue'>
-		In general, resolved values are the computed values,
-		except for a small list of legacy 2.1 properties.
-		Do we really want these properties to return the used value here?
-		<a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16906">Bug about this.</a>
+	Note: In general, resolved values are the computed values,
+	except for a small list of legacy 2.1 properties.
+	However, compatibility with early implementations of this module
+	requires us to define 'grid-template-rows' and 'grid-template-columns' as returning used values.
+	Authors are recommended to use the 
+	<a href="http://dev.w3.org/csswg/cssom/#the-getstyleutils-interface"><code>.rawComputedStyle</code> and <code>.usedStyle</code> attributes</a>
+	instead of <code>getComputedStyle()</code>.
 
 
 <h3 id="grid-template-areas-property">
@@ -1400,7 +1402,7 @@ <h3 id="grid-auto-flow-property">
 
 	<pre class='propdef'>
 	Name: grid-auto-flow
-	Value: [ rows | columns ] && dense?
+	Value: none | [ [ rows | columns ] && dense? ]
 	Initial: rows
 	Applies to: <a>grid containers</a>
 	Inherited: no
@@ -1415,6 +1417,11 @@ <h3 id="grid-auto-flow-property">
 		and whether rows or columns are added as needed to accommodate the content.
 
 	<dl dfn-for=grid-auto-flow dfn-type=value>
+		<dt><dfn>none</dfn>
+		<dd>
+			Rather than use the auto-placement algorithm,
+			auto-placed <a>grid items</a> are simply positioned according to the 'grid-auto-position' property.
+
 		<dt><dfn>rows</dfn>
 		<dd>
 			The auto-placement algorithm places items
@@ -1437,11 +1444,7 @@ <h3 id="grid-auto-flow-property">
 			Note: This may cause items to appear out-of-order.
 	</dl>
 
-	<p class='issue'>
-		Add a value for stacking items on top of each other?
-
-	<p class='issue'>
-		Add a value for flowing items together into a single slot?
+	Note: A future level of this module is expected to add a value that flows auto-positioned items together into a single “default” cell.
 
 	<p>
 		Auto-placement takes <a>grid items</a> in 'order'-modified document order.