Skip to content

Commit 22bd1bc

Browse files
committed
[css-grid-3] Simplified the sizing calcs for automatic-positioned subgrids in a grid lanes container. w3c#10926
1 parent dccc6c9 commit 22bd1bc

1 file changed

Lines changed: 25 additions & 2 deletions

File tree

css-grid-3/Overview.bs

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@ spec: css-grid-2;
3636
text: collapsed grid track
3737
text: min track sizing function
3838
text: max track sizing function
39+
text: parent grid
3940
type: value; text: grid; for: display
4041
</pre>
4142

@@ -582,6 +583,8 @@ Subgrids</h3>
582583

583584
A [=subgrid=] that is a [=grid lanes container=]
584585
can be referred to as a <dfn export>grid lanes subgrid</dfn>.
586+
To distinguish, a regular [=grid container=] [=subgrid=]
587+
can be referred to as a <dfn export>regular grid subgrid</dfn>.
585588

586589
<h3 id="repeat-notation">
587590
Track Repetition: the ''repeat()'' notation</h3>
@@ -670,7 +673,8 @@ Subgrid Item Contributions</h4>
670673

671674
When sizing the tracks of either a regular [=grid container=] or a [=grid lanes container=],
672675
a [=grid lanes subgrid=] has special handling of items that have an [=automatic grid position=]:
673-
* Any such item is placed into every possible grid track
676+
677+
* Any such item is placed into every possible [=parent grid=] track
674678
that could be spanned by the [=grid lanes subgrid=].
675679
(If the subgrid has a [=definite grid position=], thus only the spanned tracks;
676680
if it has an [=automatic grid position=], then all tracks in the parent grid.)
@@ -679,6 +683,23 @@ Subgrid Item Contributions</h4>
679683
If the item spans the entire subgrid, it receives both.
680684
(See <a href="https://www.w3.org/TR/css-grid-2/#subgrid-item-contribution">CSS Grid Layout &sect;9</a>.)
681685

686+
When sizing the tracks of a [=grid lanes container=],
687+
a [=subgrid=] with an [=automatic grid position=]
688+
(whether a [=regular grid subgrid=] or [=grid lanes subgrid=])
689+
also has special handling of its items:
690+
691+
* <em>Every</em> item is placed into every possible [=parent grid=] track
692+
that could be spanned by the [=subgrid=],
693+
(ignoring any explicit placement of the item).
694+
* Explicitly-placed sub-items only receive the subgrid's margin/border/padding contribution
695+
when their explicit placement is at an edge of the subgrid
696+
(as usual).
697+
698+
Note: Explicitly placed items inside an explicitly placed [=subgrid=]
699+
only ever contribute to their actual [=parent grid=] tracks.
700+
This is because in this case, just like in regular [=grid layout=],
701+
the item's placement is known prior to track sizing.
702+
682703
<h4 id="track-sizing-performance">
683704
Optimized Track Sizing</h4>
684705

@@ -1318,10 +1339,12 @@ Additions Since Level 2</h3>
13181339
<h3 class="no-num" id="recent-changes">
13191340
Recent Changes</h3>
13201341

1321-
The following changes have been amde since the
1342+
The following changes have been made since the
13221343
<a href="https://www.w3.org/TR/2026/WD-css-grid-3-20260121/">21 January 2026 Working Draft</a>:
13231344
* Dropped the 'item-*' proposal for unified flow controls across layout modes.
13241345
(<a href="https://github.com/w3c/csswg-drafts/issues/11480">Issue 11480</a>)
1346+
* Simplified the sizing calcs for automatic-positioned [=subgrids=] in a [=grid lanes container=].
1347+
(<a href="https://github.com/w3c/csswg-drafts/issues/10926">Issue 10926</a>)
13251348

13261349
The following changes have been made since the
13271350
<a href="https://www.w3.org/TR/2025/WD-css-grid-3-20251223/">23 December 2025 Working Draft</a>:

0 commit comments

Comments
 (0)