Skip to content

Commit 7f48ac4

Browse files
committed
[css-overflow-3] Rename 'scrollable overflow region' to 'scrollable overflow area' because we use 'area' a lot more than 'region' in CSS and I get it wrong literally every time.
1 parent 6ee4310 commit 7f48ac4

5 files changed

Lines changed: 34 additions & 34 deletions

File tree

css-align-3/Overview.bs

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Previous Version: https://www.w3.org/TR/2014/WD-css-align-3-20141218/
2424
Previous Version: https://www.w3.org/TR/2013/WD-css3-align-20130514/
2525
Previous Version: https://www.w3.org/TR/2012/WD-css3-align-20120612/
2626
Abstract: This module contains the features of <a href="https://www.w3.org/TR/CSS/">CSS</a> relating to the alignment of boxes within their containers in the various CSS box layout models: block layout, table layout, flex layout, and grid layout. (The alignment of text and inline-level content is defined in [[CSS-TEXT-3]] and [[CSS-INLINE-3]].)
27-
Ignored Terms: table cell, stretch, scrollable overflow region, static position, static-position containing block, static positions
27+
Ignored Terms: table cell, stretch, static position, static-position containing block, static positions
2828
At Risk: ''[ first | last ]? baseline''
2929
At Risk: the <<overflow-position>> keywords
3030
At Risk: the scrollable-area safety trigger into ''safe'' mode when no <<overflow-position>> is specified
@@ -848,7 +848,7 @@ Overflow Alignment: the ''safe'' and ''unsafe'' keywords and scroll safety limit
848848
the default <a>overflow alignment</a> is a blend of “safe” and “unsafe”
849849
in that an overflowing <a>alignment subject</a> is allowed to overflow its <a>alignment container</a>,
850850
but if this would cause it to also overflow
851-
the <a>scrollable overflow region</a> of its nearest ancestor <a>scroll container</a>
851+
the <a>scrollable overflow area</a> of its nearest ancestor <a>scroll container</a>
852852
(thus extending into the “unscrollable” region),
853853
then its overflow in that direction is limited
854854
by biasing any remaining overflow to the opposite side.
@@ -1106,21 +1106,21 @@ Overflow and Scroll Positions</h3>
11061106
</div>
11071107

11081108
Because the <a>scroll container</a>’s end-edge padding
1109-
is not always included in the <a>scrollable overflow region</a>
1109+
is not always included in the <a>scrollable overflow area</a>
11101110
(see [[css-overflow-3#scrollable]]),
11111111
performing such alignment might require
11121112
that the <a>alignment subject</a> be positioned
11131113
in a way that would normally not be possible just by scrolling.
11141114
To resolve this problem
11151115
(and be consistent across alignment values),
11161116
all non-''align-content/normal'' values of 'align-content'/'justify-content'
1117-
cause the <a>scrollable overflow region</a> to be extended
1117+
cause the <a>scrollable overflow area</a> to be extended
11181118
in the relevant axis
11191119
however much would be required to make it possible to scroll
11201120
to a position satisfying ''align-content/end'' alignment in that axis.
11211121
(In general, this means that the <a>scroll container</a>’s padding
11221122
is added to the bounding rectangle of its in-flow children
1123-
on <em>both</em> sides of the <a>scrollable overflow region</a>.
1123+
on <em>both</em> sides of the <a>scrollable overflow area</a>.
11241124
See [[css-overflow-3]] for details.)
11251125

11261126
<figure>
@@ -1137,10 +1137,10 @@ Overflow and Scroll Positions</h3>
11371137
it just might be initially positioned outside the <a>scrollport</a>.
11381138

11391139
Note: The <a>alignment subject</a> is not necessarily
1140-
identical to the <a>scrollable overflow region</a>:
1140+
identical to the <a>scrollable overflow area</a>:
11411141
content overflowing the <a>alignment subject</a>,
11421142
such as an absolutely-positioned or out-of-flow element,
1143-
grows the <a>scrollable overflow region</a> but not the <a>alignment subject</a>,
1143+
grows the <a>scrollable overflow area</a> but not the <a>alignment subject</a>,
11441144
thus an ''align-content/end''-aligned <a>scroll container</a>
11451145
might not be initially scrolled all the way to the bottom.
11461146

css-align-4/Overview.bs

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Previous Version: https://www.w3.org/TR/2014/WD-css-align-3-20141218/
2424
Previous Version: https://www.w3.org/TR/2013/WD-css3-align-20130514/
2525
Previous Version: https://www.w3.org/TR/2012/WD-css3-align-20120612/
2626
Abstract: This module contains the features of <a href="https://www.w3.org/TR/CSS/">CSS</a> relating to the alignment of boxes within their containers in the various CSS box layout models: block layout, table layout, flex layout, and grid layout. (The alignment of text and inline-level content is defined in [[CSS-TEXT-3]] and [[CSS-INLINE-3]].)
27-
Ignored Terms: table cell, stretch, scrollable overflow region, static position, static-position containing block, static positions
27+
Ignored Terms: table cell, stretch, static position, static-position containing block, static positions
2828
At Risk: ''[ first | last ]? baseline''
2929
At Risk: the <<overflow-position>> keywords
3030
At Risk: the scrollable-area safety trigger into ''safe'' mode when no <<overflow-position>> is specified
@@ -848,7 +848,7 @@ Overflow Alignment: the ''safe'' and ''unsafe'' keywords and scroll safety limit
848848
the default <a>overflow alignment</a> is a blend of “safe” and “unsafe”
849849
in that an overflowing <a>alignment subject</a> is allowed to overflow its <a>alignment container</a>,
850850
but if this would cause it to also overflow
851-
the <a>scrollable overflow region</a> of its nearest ancestor <a>scroll container</a>
851+
the <a>scrollable overflow area</a> of its nearest ancestor <a>scroll container</a>
852852
(thus extending into the “unscrollable” region),
853853
then its overflow in that direction is limited
854854
by biasing any remaining overflow to the opposite side.
@@ -1106,21 +1106,21 @@ Overflow and Scroll Positions</h3>
11061106
</div>
11071107

11081108
Because the <a>scroll container</a>’s end-edge padding
1109-
is not always included in the <a>scrollable overflow region</a>
1109+
is not always included in the <a>scrollable overflow area</a>
11101110
(see [[css-overflow-3#scrollable]]),
11111111
performing such alignment might require
11121112
that the <a>alignment subject</a> be positioned
11131113
in a way that would normally not be possible just by scrolling.
11141114
To resolve this problem
11151115
(and be consistent across alignment values),
11161116
all non-''align-content/normal'' values of 'align-content'/'justify-content'
1117-
cause the <a>scrollable overflow region</a> to be extended
1117+
cause the <a>scrollable overflow area</a> to be extended
11181118
in the relevant axis
11191119
however much would be required to make it possible to scroll
11201120
to a position satisfying ''align-content/end'' alignment in that axis.
11211121
(In general, this means that the <a>scroll container</a>’s padding
11221122
is added to the bounding rectangle of its in-flow children
1123-
on <em>both</em> sides of the <a>scrollable overflow region</a>.
1123+
on <em>both</em> sides of the <a>scrollable overflow area</a>.
11241124
See [[css-overflow-3]] for details.)
11251125

11261126
<figure>
@@ -1137,10 +1137,10 @@ Overflow and Scroll Positions</h3>
11371137
it just might be initially positioned outside the <a>scrollport</a>.
11381138

11391139
Note: The <a>alignment subject</a> is not necessarily
1140-
identical to the <a>scrollable overflow region</a>:
1140+
identical to the <a>scrollable overflow area</a>:
11411141
content overflowing the <a>alignment subject</a>,
11421142
such as an absolutely-positioned or out-of-flow element,
1143-
grows the <a>scrollable overflow region</a> but not the <a>alignment subject</a>,
1143+
grows the <a>scrollable overflow area</a> but not the <a>alignment subject</a>,
11441144
thus an ''align-content/end''-aligned <a>scroll container</a>
11451145
might not be initially scrolled all the way to the bottom.
11461146

css-overflow-3/Overview.bs

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ Types of Overflow</h2>
150150
creates a visual effect outside of
151151
the box's border box.
152152
Ink overflow is the overflow of painting effects defined to not affect layout
153-
or otherwise extend the <a>scrollable overflow region</a>,
153+
or otherwise extend the <a>scrollable overflow area</a>,
154154
such as <a href="https://www.w3.org/TR/css-backgrounds/#box-shadow">box shadows</a>,
155155
<a href="">border images</a>,
156156
<a href="https://www.w3.org/TR/css-text-decor-3/">text decoration</a>,
@@ -165,12 +165,12 @@ Types of Overflow</h2>
165165
do not define what visual extent they cover, the extent
166166
of the <a>ink overflow</a> is undefined.
167167

168-
The <dfn export>ink overflow region</dfn> is the non-rectangular area
168+
The <dfn export lt="ink overflow region | ink overflow area">ink overflow area</dfn> is the non-rectangular area
169169
occupied by the <a>ink overflow</a>
170170
of a box and its contents,
171171
and the <dfn export>ink overflow rectangle</dfn> is
172172
the minimal rectangle whose axes are aligned to the box's axes
173-
and that contains the <a>ink overflow region</a>.
173+
and that contains the <a>ink overflow area</a>.
174174
Note that the <a>ink overflow rectangle</a> is a rectangle
175175
in the box's coordinate system, but might be non-rectangular
176176
in other coordinate systems due to transforms. [[CSS3-TRANSFORMS]]
@@ -183,13 +183,13 @@ Scrollable Overflow</h3>
183183
set of things extending outside of that box's padding edge
184184
for which a scrolling mechanism needs to be provided.
185185

186-
The <dfn export>scrollable overflow region</dfn> is the non-rectangular region
186+
The <dfn export lt="scrollable overflow region | scrollable overflow area">scrollable overflow area</dfn> is the non-rectangular region
187187
occupied by the <a>scrollable overflow</a>, and the
188188
<dfn export>scrollable overflow rectangle</dfn> is
189189
the minimal rectangle whose axes are aligned to the box's axes
190-
and that contains the <a>scrollable overflow region</a>.
190+
and that contains the <a>scrollable overflow area</a>.
191191

192-
The <a>scrollable overflow region</a> is the union of:
192+
The <a>scrollable overflow area</a> is the union of:
193193
<ul>
194194
<li>
195195
the box’s own content and padding areas
@@ -234,7 +234,7 @@ Scrollable Overflow</h3>
234234
sufficiently accurate?
235235

236236
<li>
237-
the <a>scrollable overflow regions</a> of all of the above boxes
237+
the <a>scrollable overflow areas</a> of all of the above boxes
238238
(accounting for transforms as described above),
239239
provided they themselves have ''overflow: visible''
240240
(i.e. do not themselves trap the overflow)
@@ -246,7 +246,7 @@ Scrollable Overflow</h3>
246246
which would mean that scrollable overflow, while invisible, would still be scrollable.
247247

248248
Note: The 'mask-*' properties [[!CSS-MASKING-1]]
249-
do not affect the <a>scrollable overflow region</a>.
249+
do not affect the <a>scrollable overflow area</a>.
250250

251251
Issue: Need to evaluate compat of honoring or ignoring 'clip' and 'clip-path'.
252252

@@ -317,10 +317,10 @@ Scrolling and Clipping Overflow: the 'overflow-x', 'overflow-y', and 'overflow'
317317
is clipped to its padding edge,
318318
and if so,
319319
whether it is a <dfn export>scroll container</dfn>
320-
that allows the user to scroll clipped parts of its <a>scrollable overflow region</a>
320+
that allows the user to scroll clipped parts of its <a>scrollable overflow area</a>
321321
into view.
322322
The visual viewport of the <a>scroll container</a>
323-
(through which the <a>scrollable overflow region</a> can be viewed)
323+
(through which the <a>scrollable overflow area</a> can be viewed)
324324
coincides with its padding box,
325325
and is called the <dfn export>scrollport</dfn>.
326326

@@ -468,7 +468,7 @@ Scrolling Origin, Direction, and Restriction</h3>
468468

469469
The <dfn export>initial scroll position</dfn>,
470470
that is, the initial position of
471-
the box’s <a>scrollable overflow region</a>
471+
the box’s <a>scrollable overflow area</a>
472472
with respect to its border box,
473473
prior to any user or programmatic scrolling that changes it,
474474
is dependent on the box’s <a>writing mode</a>,
@@ -480,7 +480,7 @@ Scrolling Origin, Direction, and Restriction</h3>
480480

481481
Due to Web-compatibility constraints
482482
(caused by authors exploiting legacy bugs to surreptitiously hide content from visual readers but not search engines and/or speech output),
483-
UAs must clip the <a>scrollable overflow region</a>
483+
UAs must clip the <a>scrollable overflow area</a>
484484
of <a>scroll containers</a>
485485
on the <a>block-start</a> and </a>inline-start</a> sides of the box
486486
(thereby behaving as if they had no <a>scrollable overflow</a> on that side).

css-scroll-snap-1/Overview.bs

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -610,7 +610,7 @@ Scroll Snapping Area: the 'scroll-margin' property {#scroll-margin}
610610
or the target of {{scrollIntoView()}}),
611611
the UA should use the element's <a>scroll snap area</a>,
612612
rather than just its border box,
613-
to determine which area of the <a>scrollable overflow region</a>
613+
to determine which area of the <a>scrollable overflow area</a>
614614
to bring into view,
615615
<em>even when snapping is off
616616
or not applied on this element</em>.
@@ -827,7 +827,7 @@ Unreachable Snap Positions</h4>
827827

828828
If a <a>snap position</a> is unreachable as specified,
829829
such that aligning to it would require scrolling the <a>scroll container</a>’s viewport
830-
past the edge of its <a>scrollable overflow region</a>,
830+
past the edge of its <a>scrollable overflow area</a>,
831831
the <em>used</em> <a>snap position</a> for this <a>snap area</a>
832832
is the position resulting from scrolling <em>as much as possible</em>
833833
in each relevant axis
@@ -987,7 +987,7 @@ Choosing Snap Positions {#choosing}
987987
-----------------------------------
988988

989989
A <a>scroll container</a> can have many <a>snap areas</a>
990-
scattered throughout its <a>scrollable overflow region</a>.
990+
scattered throughout its <a>scrollable overflow area</a>.
991991
A naïve algorithm for selecting a <a>snap position</a>
992992
can produce behavior that is unintuitive for users,
993993
so care is required when designing a selection algorithm.
@@ -1007,7 +1007,7 @@ Choosing Snap Positions {#choosing}
10071007
from having difficult-to-understand effects
10081008
on the scroll position,
10091009
<a>snap positions</a> should be ignored if their elements are far outside of the “corridor”
1010-
that the <a>snapport</a> defines as it moves through the <a>scrollable overflow region</a>,
1010+
that the <a>snapport</a> defines as it moves through the <a>scrollable overflow area</a>,
10111011
or a hypothetical “corridor” in the direction of a scroll with only an <a>intended direction</a>,
10121012
or the <a>snapport</a> after an scroll with only an <a>intended end position</a>.
10131013

@@ -1218,7 +1218,7 @@ Changes Since 31 January 2019 CR {#changes-20190131}
12181218
or the target of {{scrollIntoView()}}),
12191219
the UA should use the element's <a>scroll snap area</a>,
12201220
rather than just its border box,
1221-
to determine which area of the <a>scrollable overflow region</a>
1221+
to determine which area of the <a>scrollable overflow area</a>
12221222
to bring into view<ins>,
12231223
<em>even when snapping is off
12241224
or not applied on this element</em></ins>.</p>
@@ -1308,7 +1308,7 @@ Changes Since 24 August 2017 CR {#changes-20170824}
13081308
or the target of {{scrollIntoView()}}),
13091309
the UA should use the element's <a>scroll snap area</a>,
13101310
rather than just its border box,
1311-
to determine which area of the <a>scrollable overflow region</a>
1311+
to determine which area of the <a>scrollable overflow area</a>
13121312
to bring into view.</ins></p>
13131313
</blockquote>
13141314

css-text-decor-3/Overview.bs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -880,7 +880,7 @@ Text Shadows: the 'text-shadow' property</h2>
880880
and may show through if the text is partially-transparent.
881881
Like 'box-shadow', text shadows do not influence layout,
882882
and do not trigger scrolling
883-
or increase the size of the <a>scrollable overflow region</a>.
883+
or increase the size of the <a>scrollable overflow area</a>.
884884

885885
Note: The painting order of shadows defined here is the opposite
886886
of that defined in the 1998
@@ -918,7 +918,7 @@ Overflow of Text Decorations</h3>
918918

919919
Text decorations that leak outside a <a>box</a>
920920
are considered <a>ink overflow</a>:
921-
they do not extend the <a>scrollable overflow region</a>.
921+
they do not extend the <a>scrollable overflow area</a>.
922922
[[css-overflow-3]]
923923

924924
<h2 class="no-num" id="acknowledgements">

0 commit comments

Comments
 (0)