Skip to content

Commit 0d4b5d7

Browse files
committed
[css-scroll-snap] scroll snap target area -> snap viewport, per TabAtkins' preference. (Alternate consideration was 'viewport snap target')
1 parent ca3149b commit 0d4b5d7

1 file changed

Lines changed: 22 additions & 22 deletions

File tree

css-scroll-snap/Overview.bs

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,7 @@ Scroll Snapping Model {#snap-model}
209209
Valid <a>snap positions</a> can be specified
210210
as a particular alignment ('scroll-snap-align')
211211
of an element's <a>scroll snap area</a> ('scroll-snap-area', defaulting to its margin box)
212-
within the <a>scroll container</a>’s <a>snap target area</a>
212+
within the <a>scroll container</a>’s <a>snap viewport</a>
213213
(its viewport, as reduced by 'scroll-snap-padding').
214214
This is conceptually equivalent to specifying the alignment of
215215
an <a>alignment subject</a> within an <a>alignment container</a>.
@@ -324,7 +324,7 @@ Scroll Snapping Window: the 'scroll-snap-padding' property {#snap-padding}
324324
Media: interactive
325325
</pre>
326326

327-
The 'scroll-snap-padding' property defines the <dfn local-lt="snap target area">scroll snap target area</dfn>--
327+
The 'scroll-snap-padding' property defines the <dfn local-lt="snap viewport">scroll snap viewport</dfn>--
328328
the area of the viewport that is used as the <a>alignment container</a>
329329
when aligning a <a>scroll snap area</a> to a <a>snap position</a>.
330330
Values are interpreted as for 'padding',
@@ -369,7 +369,7 @@ Scroll Snapping Coordinates: the 'scroll-snap-points-x' and 'scroll-snap-points-
369369
Initial: none
370370
Applies to: <a>scroll containers</a>
371371
Inherited: no
372-
Percentages: relative to the size of the <a>snap target area</a> in the appropriate axis
372+
Percentages: relative to the size of the <a>snap viewport</a> in the appropriate axis
373373
Computed value: as specified, with lengths made absolute and clamped (see below)
374374
Animatable: no
375375
Media: interactive
@@ -442,7 +442,7 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
442442
Initial: none
443443
Applies to: all elements
444444
Inherited: no
445-
Percentages: refer to size of scroll container's <a>snap target area</a> <em>minus</em> size of box's <a>snap area</a>
445+
Percentages: refer to size of scroll container's <a>snap viewport</a> <em>minus</em> size of box's <a>snap area</a>
446446
Computed value: an optional ''point'' keyword, plus one or two alignment values
447447
each consisting of either a ''none'' or ''edges'' keyword or a percentage
448448
Animatable: no
@@ -451,7 +451,7 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
451451

452452
Specifies the element's <a>snap position</a> as an alignment of
453453
its <a>snap area</a> (as the <a>alignment subject</a>)
454-
within the viewport's <a>snap target area</a> (as the <a>alignment container</a>).
454+
within the viewport's <a>snap viewport</a> (as the <a>alignment container</a>).
455455
The <a>scroll alignment values</a> can be specified per-axis,
456456
or as a simultaneous 2D alignment position,
457457
by using a <a>scroll axis keyword</a>.
@@ -470,16 +470,16 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
470470

471471
<div class="example">
472472
The following example aligns the start edge of the box's <a>snap area</a>
473-
to the start edge of the scroll container's <a>snap target area</a>:
473+
to the start edge of the scroll container's <a>snap viewport</a>:
474474
<pre>section { scroll-snap-align: start; }</pre>
475475

476476
The following example aligns the center of each city
477-
to the center of the scroll container's <a>snap target area</a>,
477+
to the center of the scroll container's <a>snap viewport</a>,
478478
snapping only when the city is centered in both axes:
479479
<pre>city { scroll-snap-align: center point; }</pre>
480480

481481
The following example aligns the center of each photo
482-
to the center of the scroll container's <a>snap target area</a>,
482+
to the center of the scroll container's <a>snap viewport</a>,
483483
snapping independently in each axis:
484484
<pre>img { scroll-snap-align: center; }</pre>
485485
</div>
@@ -494,25 +494,25 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
494494
<dt><dfn>start</dfn>
495495
<dd>
496496
Start alignment of this box's <a>scroll snap area</a>
497-
within the <a>scroll container</a>'s <a>scroll snap target area</a>
497+
within the <a>scroll container</a>'s <a>snap viewport</a>
498498
is a valid <a>snap position</a>.
499499

500500
<dt><dfn>end</dfn>
501501
<dd>
502502
End alignment of this box's <a>scroll snap area</a>
503-
within the <a>scroll container</a>'s <a>scroll snap target area</a>
503+
within the <a>scroll container</a>'s <a>snap viewport</a>
504504
is a valid <a>snap position</a>.
505505

506506
<dt><dfn>center</dfn>
507507
<dd>
508508
Center alignment of this box's <a>scroll snap area</a>
509-
within the <a>scroll container</a>'s <a>scroll snap target area</a>
509+
within the <a>scroll container</a>'s <a>snap viewport</a>
510510
is a valid <a>snap position</a>.
511511

512512
<dt><dfn><<percentage>></dfn>
513513
<dd>
514514
Percentage alignment of this box's <a>scroll snap area</a>
515-
within the <a>scroll container</a>'s <a>scroll snap target area</a>
515+
within the <a>scroll container</a>'s <a>snap viewport</a>
516516
is a valid <a>snap position</a>,
517517
where the percentage represents a position between
518518
''scroll-snap-align/start'' alignment and ''scroll-snap-align/end'' alignment.
@@ -521,7 +521,7 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
521521
<dt><dfn>edges</dfn>
522522
<dd>
523523
Both start alignment and end alignment of this box's <a>scroll snap area</a>
524-
within the <a>scroll container</a>'s <a>scroll snap target area</a>
524+
within the <a>scroll container</a>'s <a>snap viewport</a>
525525
are valid <a>snap positions</a>.
526526
</dl>
527527

@@ -569,8 +569,8 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
569569
Note: Remember that in <a>vertical writing modes</a> the block and inline axes
570570
correspond to the x and y axes, and not the y and x axes, respectively.
571571

572-
If the <a>snap area</a> is larger than the <a>snap target area</a> in a particular axis,
573-
then any scroll position in which the <a>snap area</a> covers the <a>snap target area</a>
572+
If the <a>snap area</a> is larger than the <a>snap viewport</a> in a particular axis,
573+
then any scroll position in which the <a>snap area</a> covers the <a>snap viewport</a>
574574
is a valid <a>snap position</a> in that axis.
575575
The UA may use the specified alignment as a more precise target
576576
for certain scroll operations (e.g. inertial scrolling or explicit paging).
@@ -581,7 +581,7 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
581581
but if the item happens to be larger than your viewport,
582582
you want to be able to scroll around the whole thing once you're over it.
583583

584-
Since the <a>snap area</a> is larger than the <a>snap target area</a>,
584+
Since the <a>snap area</a> is larger than the <a>snap viewport</a>,
585585
while the area fully fills the viewport,
586586
the container can be scrolled arbitrarily and will not try to snap back to its aligned position.
587587
However, if the container is scrolled such that the area
@@ -721,7 +721,7 @@ Types of Scrolling Gestures {#scroll-types}
721721
in both axises at once,
722722
aligning a particular point in the element
723723
with a corresponding point in the <a>scroll container</a>’s
724-
<a>snap target area</a>.
724+
<a>snap viewport</a>.
725725

726726
This type of <a>snap position</a> is intended for truly "two-dimensional" layouts,
727727
such as cities on a map
@@ -765,10 +765,10 @@ Choosing Snap Positions {#choosing}
765765
according to the amount of other-axis scrolling they would cause.
766766

767767
* <a>Snap positions</a> should be ignored if their elements are far outside of the "corridor"
768-
that the <a>snap target area</a> defines as it moves through the <a>scrollable area</a>
768+
that the <a>snap viewport</a> defines as it moves through the <a>scrollable area</a>
769769
during an <a>inertial scroll</a>,
770770
or a hypothetical "corridor" in the direction of a <a>semantic scroll</a>,
771-
or the <a>snap target area</a> after an <a>explicit scroll</a>.
771+
or the <a>snap viewport</a> after an <a>explicit scroll</a>.
772772
(This is to prevent a far-offscreen element
773773
from having difficult-to-understand effects
774774
on the scroll position.)
@@ -905,7 +905,7 @@ Physical Longhands for 'scroll-snap-padding' {#padding-longhands-physical}
905905

906906
These <a>longhands</a> of 'scroll-snap-padding' specify
907907
the top, right, bottom, and left
908-
edges of the <a>scroll snap target area</a>,
908+
edges of the <a>snap viewport</a>,
909909
respectively.
910910

911911
Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
@@ -924,7 +924,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
924924

925925
These <a>longhands</a> of 'scroll-snap-padding' specify
926926
the block-start, inline-start, block-end, and inline-end
927-
edges of the <a>scroll snap target area</a>,
927+
edges of the <a>snap viewport</a>,
928928
respectively.
929929

930930
<pre class="propdef">
@@ -942,7 +942,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
942942
and 'scroll-snap-area-inline-start' + 'scroll-snap-area-inline-end'
943943
are <a>longhands</a> of 'scroll-snap-padding', and
944944
specify the block-axis and inline-axis
945-
edges of the <a>scroll snap target area</a>,
945+
edges of the <a>snap viewport</a>,
946946
respectively.
947947
If two values are specified, the first gives the start value
948948
and the second gives the end value.

0 commit comments

Comments
 (0)