@@ -103,6 +103,9 @@ Introduction</h2>
103
103
<h3 id='background'>
104
104
Background and Motivation</h3>
105
105
106
+ <h4 id='waterfall'>
107
+ Waterfall Layout with Auto-placed Items</h4>
108
+
106
109
[=Masonry layout=] , sometimes also called “waterfall layout”,
107
110
is a common Web design pattern where a number of items--
108
111
commonly images or short article summaries--
@@ -141,6 +144,49 @@ Background and Motivation</h3>
141
144
unless you know up-front how tall each item will be,
142
145
or use JavaScript for content measurement or placement.
143
146
147
+ Using a [=masonry container=] together with ''grid-area/auto'' -positioned items
148
+ yields this type of masonry layout.
149
+
150
+ <h4 id='collapse'>
151
+ One-dimensional Grid Layout</h4>
152
+
153
+ [=Grid layout=] allows for powerful track sizing and explicit placement in two axes,
154
+ but sometimes a layout only needs alignment of its items in one dimension.
155
+
156
+ Using a [=masonry container=] together with explicitly-positioned items
157
+ allows for this type of one-dimensional grid layout.
158
+
159
+ <div class="example">
160
+ In this example <a href="https://github.com/w3c/csswg-drafts/issues/10233#issuecomment-2071279204">by Douglas Graham</a> ,
161
+ the items use explicit positioning to place each item into its assigned column;
162
+ but there are no rows.
163
+ Instead, items in each column stack one after the other.
164
+ This layout can't be duplicated in [=grid layout=]
165
+ because the “spanning” relationships among the items in adjacent columns
166
+ is not fixed: it depends on their relative heights,
167
+ and whether the optional banner or advertisement items are included.
168
+ It also can't be duplicated in [=flex layout=]
169
+ because the source order of the items
170
+ (which is used for reading, sequential navigation, and one-column mobile phone layout)
171
+ goes back and forth between the two columns.
172
+
173
+ <figure>
174
+ <!-- https://codepen.io/TabAtkins/pen/abeoBOm -->
175
+ <img src="images/masonry-page-layout.png"
176
+ alt="In one-column layout:
177
+ the header, followed by an optional banner, the secondary navigation,
178
+ the main content area, an advertisement block, and finally the footer.
179
+ In two-column layout:
180
+ the header spanning both columns on top,
181
+ the footer spanning both columns at the bottom,
182
+ in the wider left column the optional banner followed by the main content area,
183
+ and in the narrow left column the secondary navigation followed by the advertisement block.">
184
+ <figcaption>
185
+ Comparison of one-column and two-column variants of a one-dimensional grid page layout.
186
+ </figcaption>
187
+ </figure>
188
+ </div>
189
+
144
190
<h3 id="alternative-proposals">
145
191
Alternative Syntax Proposals</h3>
146
192
0 commit comments