Skip to content

Commit 7b49fb4

Browse files
committed
[css-grid] Remove grid-auto-position and grid-auto-flow:none, add grid-auto-flow:stack, per WG resolution.
1 parent cb5d4c7 commit 7b49fb4

2 files changed

Lines changed: 41 additions & 101 deletions

File tree

css-grid/Overview.bs

Lines changed: 18 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1447,8 +1447,8 @@ Automatic Placement: the 'grid-auto-flow' property</h3>
14471447

14481448
<pre class='propdef'>
14491449
Name: grid-auto-flow
1450-
Value: none | [ [ row | column ] && dense? ]
1451-
Initial: none
1450+
Value: [ [ row | column ] && dense? ] | [ stack && [ row | column ]? ]
1451+
Initial: row
14521452
Applies to: <a>grid containers</a>
14531453
Inherited: no
14541454
Percentages: n/a
@@ -1461,11 +1461,6 @@ Automatic Placement: the 'grid-auto-flow' property</h3>
14611461
and whether rows or columns are added as needed to accommodate the content.
14621462

14631463
<dl dfn-for=grid-auto-flow dfn-type=value>
1464-
<dt><dfn>none</dfn>
1465-
<dd>
1466-
Rather than use the auto-placement algorithm,
1467-
auto-placed <a>grid items</a> are simply positioned according to the 'grid-auto-position' property.
1468-
14691464
<dt><dfn>row</dfn>
14701465
<dd>
14711466
The <a>auto-placement algorithm</a> places items
@@ -1486,18 +1481,26 @@ Automatic Placement: the 'grid-auto-flow' property</h3>
14861481
permanently skipping spaces that it can't fill with the current <a>grid item</a>.)
14871482

14881483
Note: This may cause items to appear out-of-order.
1484+
1485+
<dt><dfn>stack</dfn>
1486+
<dd>
1487+
The auto-placement algorithm is run with a single hypothetical 1×1 grid item,
1488+
as if ''grid-auto-flow: row'' or ''grid-auto-flow: column'' were specified,
1489+
depending on whether ''row'' or ''column'' is specified alongside it,
1490+
respectively.
1491+
If neither ''row'' nor ''column'' are specified,
1492+
it defaults to running the algorithm as if ''grid-auto-flow: row'' were specified.
1493+
1494+
Wherever the hypothetical item would be placed,
1495+
all auto-placed items are placed there,
1496+
stacked atop one another.
1497+
(This happens even if the auto-placed item is greater than 1×1,
1498+
even if doing so would cause it to overlap explicitly-placed <a>grid items</a>.)
14891499
</dl>
14901500

14911501
Note: A future level of this module is expected to add a value that flows auto-positioned items together into a single “default” cell.
14921502

1493-
<p class='issue'>
1494-
Win8 compat might require the ''grid-auto-flow/none'' value to stay the initial value,
1495-
but it's not a very good value,
1496-
because by default the entire contents of a grid container will end up stacked on top of each other.
1497-
See <a href="http://lists.w3.org/Archives/Public/www-archive/2013Aug/0024.html">proposals to address this</a>
1498-
while addressing use cases and back-compat.
1499-
1500-
Auto-placement takes <a>grid items</a> in <a>order-modified document order</a>.
1503+
Auto-placement takes <a>grid items</a> in <a>order-modified document order</a>.
15011504

15021505
<div class='example'>
15031506
In the following example, there are three columns, each auto-sized to their contents.
@@ -1716,36 +1719,6 @@ Automatic Grid Item Placement Algorithm</h4>
17161719
reset the <a>auto-placement cursor</a> to 1/1 each time an item is placed.
17171720
</ol>
17181721

1719-
<h3 id="grid-auto-position-property">
1720-
Default Position: the 'grid-auto-position' property</h3>
1721-
1722-
<pre class='propdef'>
1723-
Name: grid-auto-position
1724-
Value: <<grid-line>> / <<grid-line>>
1725-
Initial: 1 / 1
1726-
Applies to: <a>grid containers</a>
1727-
Inherited: no
1728-
Percentages: n/a
1729-
Media: visual
1730-
Computed value: specified value
1731-
</pre>
1732-
1733-
If a <a>grid container</a> doesn't specify an automatic-placement strategy through 'grid-auto-flow',
1734-
any grid items with an <a>automatic grid position</a> are instead all placed at the default position
1735-
specified by 'grid-auto-position'.
1736-
1737-
Interpret the two <<grid-line>>s as if they were specified in 'grid-column-start' and 'grid-row-start', respectively,
1738-
of a hypothetical <a>grid item</a>,
1739-
treating <a value for=grid-row-start>auto</a> as ''1'' for this purpose.
1740-
The resulting lines of the <a>grid container</a>
1741-
become a <a>definite grid position</a> in both axes
1742-
for the auto-placed <a>grid items</a>.
1743-
1744-
<p class="issue">
1745-
These properties might not be necessary in this level,
1746-
if we can provide a more reasonable default behavior
1747-
by, e.g., searching for an empty slot to stack items into
1748-
instead of always using 1,1 by default.
17491722

17501723
<h2 id='grid-shorthand'>
17511724
Grid Definition Shorthand: the 'grid' property</h2>

0 commit comments

Comments
 (0)