Skip to content

Commit c423229

Browse files
authored
[css-grid-3] Rename 'item-tolerance' to 'flow-tolerance' (w3c#13313)
Fixes w3c#10884
1 parent ee144ef commit c423229

1 file changed

Lines changed: 26 additions & 27 deletions

File tree

css-grid-3/Overview.bs

Lines changed: 26 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,7 @@ Reordering and Accessibility</h3>
261261
(placing the next item endward of the current item in at least one axis,
262262
matching the natural “reading order”),
263263
it can switch between endward in the inline or block axis in a seemingly arbitrary manner.
264-
In simple cases, the 'item-tolerance' property can help reduce
264+
In simple cases, the 'flow-tolerance' property can help reduce
265265
the feeling of backtracking due to small sizing differences in the [=stacking axis=]
266266
when laying out auto-placed items.
267267
But when [[#grid-lanes-layout-algorithm|auto-placement]] is mixed with [=definite position|explicit placement=] or spanning items,
@@ -321,7 +321,7 @@ Reordering and Accessibility</h3>
321321

322322
<div class=note>
323323
Techniques for reducing backtracking include:
324-
* Using appropriate values for 'item-tolerance',
324+
* Using appropriate values for 'flow-tolerance',
325325
i.e. values large enough to avoid gratuitous differentiation among similarly-sized tracks,
326326
but not so large that meaningful differences get ignored.
327327
* Using explicit placement in ways that help group related items together,
@@ -761,10 +761,10 @@ Specifying Grid Axis Item Placement: the 'grid-column-*' and 'grid-row-*' proper
761761
and establish placement just as in regular [=grid layout=].
762762

763763
<h3 id=placement-tolerance oldids="item-slack">
764-
Placement Precision: the 'item-tolerance' property</h3>
764+
Placement Precision: the 'flow-tolerance' property</h3>
765765

766766
<pre class=propdef>
767-
Name: item-tolerance
767+
Name: flow-tolerance
768768
Value: normal | <<length-percentage>> | infinite
769769
Initial: normal
770770
Percentages: relative to the [=grid-axis=] [=content box=] size of the [=grid lanes container=]
@@ -783,11 +783,11 @@ Placement Precision: the 'item-tolerance' property</h3>
783783
it can look strange to have them not fill in order,
784784
as the height differences aren't perceived as <em>meaningfully</em> different.
785785

786-
The 'item-tolerance' property specifies what the threshold is
786+
The 'flow-tolerance' property specifies what the threshold is
787787
for considering tracks to be “the same height”,
788788
causing them to fill in order.
789789

790-
<dl dfn-type=value dfn-for=item-slack>
790+
<dl dfn-type=value dfn-for=flow-tolerance>
791791
: <dfn><<length-percentage>></dfn>
792792
:: Specifies the <dfn dfn for="grid lanes">tie threshold</dfn>
793793
for the [=grid lanes container=].
@@ -836,8 +836,6 @@ Placement Precision: the 'item-tolerance' property</h3>
836836
only the fourth column is a possible placement.
837837
</div>
838838

839-
ISSUE(10884): The CSSWG is open to better names for this property.
840-
841839
Note: We expect to apply this property to [=flex layout=] in the future also,
842840
see <a href='https://github.com/w3c/csswg-drafts/issues/3071'>discussions</a>
843841
on how that might work.
@@ -1332,8 +1330,8 @@ Appendix A: Generic Layout Item Flow Controls: the 'item-*' properties</h2>
13321330
<td>
13331331
<td>'grid-auto-flow'
13341332
<tr>
1335-
<td>'item-tolerance'
1336-
<td>'item-tolerance'
1333+
<td>'flow-tolerance'
1334+
<td>'flow-tolerance'
13371335
<td>normal | <<length-percentage>> | infinite
13381336
<td>
13391337
Defines a layout-specific amount of “slack” in placement decisions.
@@ -1534,7 +1532,7 @@ Item Placement Shorthand: the 'item-flow' shorthand</h3>
15341532

15351533
<pre class="propdef shorthand">
15361534
Name: item-flow
1537-
Value: <<'item-direction'>> || <<'item-wrap'>> || <<'item-pack'>> || <<'item-tolerance'>>
1535+
Value: <<'item-direction'>> || <<'item-wrap'>> || <<'item-pack'>> || <<'flow-tolerance'>>
15381536
</pre>
15391537

15401538
This [=shorthand property=] sets all its 'item-*' [=longhand properties=]
@@ -1598,7 +1596,6 @@ Recent Changes</h3>
15981596

15991597
The following changes have been made since the
16001598
<a href='https://www.w3.org/TR/2025/WD-css-grid-3-20250917/'>17 September 2025 Working Draft</a>:
1601-
16021599
* Defined a new inner display type, ''display/grid-lanes'', to establish [=grid lanes layout=],
16031600
and updated spec vocabulary to match.
16041601
(<a href="https://github.com/w3c/csswg-drafts/issues/12022">Issue 12022</a>)
@@ -1608,6 +1605,8 @@ Recent Changes</h3>
16081605
(<a href="https://github.com/w3c/csswg-drafts/issues/12899">Issue 12899</a>)
16091606
* Floored the contribution of items to a track's [=running position=] at zero.
16101607
(<a href="https://github.com/w3c/csswg-drafts/issues/12918">Issue 12918</a>)
1608+
* Renamed ''item-tolerance'' to ''flow-tolerance''.
1609+
(<a href="https://github.com/w3c/csswg-drafts/issues/10884">Issue 10884</a>)
16111610

16121611
See also <a href="https://www.w3.org/TR/2025/WD-css-grid-3-20250917/#recent-changes">earlier changes</a>.
16131612

@@ -1782,18 +1781,18 @@ item-placement/grid-lanes-item-placement-006.html
17821781
item-placement/grid-lanes-item-placement-007.html
17831782
item-placement/grid-lanes-item-placement-008.html
17841783
item-placement/grid-lanes-rows-with-grid-width-changed.html
1785-
item-placement/item-tolerance/column-initial-item-tolerance.html
1786-
item-placement/item-tolerance/column-item-tolerance-infinite.html
1787-
item-placement/item-tolerance/item-tolerance-column-001.html
1788-
item-placement/item-tolerance/item-tolerance-column-002.html
1789-
item-placement/item-tolerance/item-tolerance-column-003.html
1790-
item-placement/item-tolerance/item-tolerance-column-004.html
1791-
item-placement/item-tolerance/item-tolerance-row-001.html
1792-
item-placement/item-tolerance/item-tolerance-row-002.html
1793-
item-placement/item-tolerance/item-tolerance-row-003.html
1794-
item-placement/item-tolerance/item-tolerance-row-004.html
1795-
item-placement/item-tolerance/row-initial-item-tolerance.html
1796-
item-placement/item-tolerance/row-item-tolerance-infinite.html
1784+
item-placement/flow-tolerance/column-initial-flow-tolerance.html
1785+
item-placement/flow-tolerance/column-flow-tolerance-infinite.html
1786+
item-placement/flow-tolerance/flow-tolerance-column-001.html
1787+
item-placement/flow-tolerance/flow-tolerance-column-002.html
1788+
item-placement/flow-tolerance/flow-tolerance-column-003.html
1789+
item-placement/flow-tolerance/flow-tolerance-column-004.html
1790+
item-placement/flow-tolerance/flow-tolerance-row-001.html
1791+
item-placement/flow-tolerance/flow-tolerance-row-002.html
1792+
item-placement/flow-tolerance/flow-tolerance-row-003.html
1793+
item-placement/flow-tolerance/flow-tolerance-row-004.html
1794+
item-placement/flow-tolerance/row-initial-flow-tolerance.html
1795+
item-placement/flow-tolerance/row-flow-tolerance-infinite.html
17971796
item-placement/row-auto-placement-001.html
17981797
item-placement/row-auto-placement-002.html
17991798
item-placement/row-auto-placement-max-content.html
@@ -1866,9 +1865,9 @@ parsing/grid-lanes-shorthand-computed.html
18661865
parsing/grid-lanes-shorthand-invalid.html
18671866
parsing/grid-lanes-shorthand-serialization.html
18681867
parsing/grid-lanes-shorthand-valid.html
1869-
parsing/item-tolerance-computed.html
1870-
parsing/item-tolerance-invalid.html
1871-
parsing/item-tolerance-valid.html
1868+
parsing/flow-tolerance-computed.html
1869+
parsing/flow-tolerance-invalid.html
1870+
parsing/flow-tolerance-valid.html
18721871
row-empty-grid-lanes-container-001.html
18731872
row-empty-grid-lanes-container-002.html
18741873
row-min-max-content-container.html

0 commit comments

Comments
 (0)