Skip to content

Commit 08ac85c

Browse files
committed
[css-grid-3][masonry] Rename item-slack to item-tolerance #10884
1 parent 038abff commit 08ac85c

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

css-grid-3/Overview.bs

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -272,7 +272,7 @@ Reordering and Accessibility</h3>
272272
(placing the next item down or endward of the current item,
273273
matching the natural "reading order"),
274274
it can switch between these two in a seemingly arbitrary manner.
275-
In simple cases, the 'item-slack' property can help reduce
275+
In simple cases, the 'item-tolerance' property can help reduce
276276
the feeling of backtracking due to small sizing differences in the [=block axis=]
277277
when laying out auto-placed items.
278278
But when [[#masonry-layout-algorithm|auto-placement]] is mixed with [=definite position|explicit placement=] or spanning items,
@@ -332,7 +332,7 @@ Reordering and Accessibility</h3>
332332

333333
<div class=note>
334334
Techniques for reducing backtracking include:
335-
* Using appropriate values for 'item-slack',
335+
* Using appropriate values for 'item-tolerance',
336336
i.e. values large enough to avoid gratuitous differentiation among similarly-sized tracks,
337337
but not so large that meaningful differences get ignored.
338338
* Using explicit placement in ways that help group related items together,
@@ -752,11 +752,11 @@ Specifying Masonry Item Placement: the 'grid-column-*' and 'grid-row-*' properti
752752
and establish placement just as in regular [=grid layout=].
753753

754754

755-
<h3 id="item-slack">
756-
Placement Precision: the 'item-slack' property</h3>
755+
<h3 id=placement-tolerance oldids="item-slack">
756+
Placement Precision: the 'item-tolerance' property</h3>
757757

758758
<pre class=propdef>
759-
Name: item-slack
759+
Name: item-tolerance
760760
Value: <<length-percentage>> | infinite
761761
Initial: 1em
762762
Percentages: relative to the [=grid-axis=] [=content box=] size of the [=masonry container=]
@@ -775,7 +775,7 @@ Placement Precision: the 'item-slack' property</h3>
775775
it can look strange to have them not fill in order,
776776
as the height differences aren't perceived as <em>meaningfully</em> different.
777777

778-
The 'item-slack' property specifies what the threshold is
778+
The 'item-tolerance' property specifies what the threshold is
779779
for considering tracks to be “the same height”,
780780
causing them to fill in order.
781781

@@ -806,6 +806,7 @@ Placement Precision: the 'item-slack' property</h3>
806806

807807
Issue: Is ''1em'' the right default?
808808

809+
ISSUE(10884): The CSSWG is open to better names for this property.
809810

810811
<h3 id="masonry-layout-algorithm">
811812
Masonry Layout and Placement Algorithm</h3>
@@ -1211,11 +1212,11 @@ Appendix A: Generic Layout Item Flow Controls: the 'item-*' properties</h2>
12111212
<td>
12121213
<td>'grid-auto-flow'
12131214
<tr>
1214-
<td>'item-slack'
1215-
<td>'item-slack'
1215+
<td>'item-tolerance'
1216+
<td>'item-tolerance'
12161217
<td>normal | <<length-percentage>> | infinite
12171218
<td>
1218-
Defines a layout-specific amount of "slack" in placement decisions.
1219+
Defines a layout-specific amount of slack in placement decisions.
12191220
<td>
12201221
<td>
12211222
</table>
@@ -1423,7 +1424,7 @@ Item Placement Shorthand: the 'item-flow' shorthand</h3>
14231424

14241425
<pre class="propdef shorthand">
14251426
Name: item-flow
1426-
Value: <<'item-direction'>> || <<'item-wrap'>> || <<'item-pack'>> || <<'item-slack'>>
1427+
Value: <<'item-direction'>> || <<'item-wrap'>> || <<'item-pack'>> || <<'item-tolerance'>>
14271428
</pre>
14281429

14291430
This [=shorthand property=] sets all its 'item-*' [=longhand properties=]
@@ -1480,7 +1481,7 @@ Recent Changes</h3>
14801481
* Introduced 'item-flow' and the 'item-*' longhands,
14811482
replacing <css>masonry-flow</css> and related properties.
14821483
(<a href="https://github.com/w3c/csswg-drafts/issues/11480">Issue 11480</a>)
1483-
* Renamed <css>masonry-slack</css> to 'item-slack'.
1484+
* Renamed <css>masonry-slack</css> to 'item-tolerance'.
14841485

14851486
<wpt hidden>
14861487
alignment/masonry-align-content-001.html

0 commit comments

Comments
 (0)