Skip to content

Commit fdf5ea1

Browse files
committed
[css-grid-2] Specify the computed and resolved values of a subgrid's grid-template-*. #4362
1 parent f15e1e6 commit fdf5ea1

File tree

1 file changed

+57
-0
lines changed

1 file changed

+57
-0
lines changed

css-grid-2/Overview.bs

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@ Establishing a Subgrid</h3>
101101
<pre class="propdef partial">
102102
Name: grid-template-rows, grid-template-columns
103103
New values: subgrid <<line-name-list>>?
104+
New computed values: The ''subgrid'' keyword followed by a <<line-name-list>>.
104105
</pre>
105106

106107
<dl dfn-for="grid-template-rows, grid-template-columns" dfn-type=value>
@@ -464,6 +465,62 @@ Characteristics of a Subgrid Item</h3>
464465
(Note: the act of scrolling does not affect layout.)
465466
</ul>
466467

468+
<!--
469+
████████ ████████ ██████ ███████ ██ ██ ██ ████████ ████████
470+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
471+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
472+
████████ ██████ ██████ ██ ██ ██ ██ ██ ██████ ██ ██
473+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
474+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
475+
██ ██ ████████ ██████ ███████ ████████ ███ ████████ ████████
476+
-->
477+
478+
<h3 id='resolved-track-list'>
479+
Resolved Value of a Track Listing</h3>
480+
481+
When an element generates a [=grid container=] box that is a [=subgrid=],
482+
the [=resolved value=]
483+
of the 'grid-template-rows' and 'grid-template-columns' properties is the <a>used value</a>,
484+
serialized as the ''subgrid'' keyword
485+
followed by a list representing each of its lines
486+
as a [=line name set=] of all the line's names,
487+
whether the names were explicitly created for the subgrid
488+
or adopted from the parent grid,
489+
without using the ''repeat()'' notation.
490+
491+
<div class="example">
492+
For example,
493+
when applied to a [=subgrid=] with ''grid-column: span 4'',
494+
each of the following 'grid-template-columns' [=specified values=]
495+
becomes the corresponding [=resolved values=]:
496+
497+
<pre class="lang-css">
498+
specified: subgrid [a] repeat(auto-fill, [b]) [c]
499+
resolved: subgrid [a] [b] [b] [b] [c]
500+
</pre>
501+
502+
<pre class=lang-css>
503+
specified: subgrid [a] [a] [a] [a] repeat(auto-fill, [b]) [c] [c]
504+
resolved: subgrid [a] [a] [a] [a] [c]
505+
</pre>
506+
507+
<pre class="lang-css">
508+
specified: subgrid [] [a]
509+
resolved: subgrid [] [a] [] [] []
510+
</pre>
511+
512+
<pre class="lang-css">
513+
specified: subgrid [a] [b] [c] [d] [e] [f]
514+
resolved: subgrid [a] [b] [c] [d] [e]
515+
</pre>
516+
</div>
517+
518+
Note: This violates the general
519+
"shortest equivalent serialization" principle
520+
by serializing empty trailing [=line name sets=],
521+
as the trailing [=line name sets=] provide potentially-useful information
522+
about how many tracks the subgrid is spanning.
523+
467524
<h3 id="subgrid-sizing">
468525
Subgrid Sizing Algorithm</h3>
469526

0 commit comments

Comments
 (0)