Skip to content

Commit 67169e2

Browse files
committed
[css-scroll-snap] snap viewport -> snap window (for less confusion)
1 parent d91e995 commit 67169e2

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
@@ -179,7 +179,7 @@ Scroll Snapping Model {#snap-model}
179179
as a particular alignment ('scroll-snap-align')
180180
of an element's <a>scroll snap area</a>
181181
(its border box, as modified by 'scroll-snap-margin')
182-
within the <a>scroll container</a>’s <a>snap viewport</a>
182+
within the <a>scroll container</a>’s <a>snap window</a>
183183
(its visual viewport, as reduced by 'scroll-snap-padding').
184184
This is conceptually equivalent to specifying the alignment of
185185
an <a>alignment subject</a> within an <a>alignment container</a>.
@@ -414,7 +414,7 @@ Scroll Snapping Window: the 'scroll-snap-padding' property {#snap-padding}
414414
Media: interactive
415415
</pre>
416416

417-
The 'scroll-snap-padding' property defines the <dfn local-lt="snap viewport">scroll snap viewport</dfn>--
417+
The 'scroll-snap-padding' property defines the <dfn local-lt="snap window">scroll snap window</dfn>--
418418
the area of the viewport that is used as the <a>alignment container</a>
419419
when aligning a <a>scroll snap area</a> to its <a>snap position</a>.
420420
Values are interpreted as for 'padding',
@@ -515,20 +515,20 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-alignm
515515

516516
Specifies the element's <a>snap position</a> as an alignment of
517517
its <a>snap area</a> (as the <a>alignment subject</a>)
518-
within its <a>snap container's</a> <a>snap viewport</a> (as the <a>alignment container</a>).
518+
within its <a>snap container's</a> <a>snap window</a> (as the <a>alignment container</a>).
519519
The two values specify the snapping behavior in the <a>inline axis</a> and <a>block axis</a>,
520520
respectively.
521521
If only one value is specified,
522522
the second value defaults to the same value.
523523

524524
<div class="example">
525525
The following example aligns the start edge of the box's <a>snap area</a>
526-
to the start edge of the scroll container's <a>snap viewport</a>:
526+
to the start edge of the scroll container's <a>snap window</a>:
527527

528528
<pre>section { scroll-snap-align: start; }</pre>
529529

530530
The following example aligns the center of each city
531-
to the center of the scroll container's <a>snap viewport</a>,
531+
to the center of the scroll container's <a>snap window</a>,
532532
snapping only when the city is centered in both axes:
533533

534534
<pre>
@@ -537,7 +537,7 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-alignm
537537
</pre>
538538

539539
The following example aligns the center of each photo
540-
to the center of the scroll container's <a>snap viewport</a>,
540+
to the center of the scroll container's <a>snap window</a>,
541541
snapping independently in each axis:
542542

543543
<pre>
@@ -556,19 +556,19 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-alignm
556556
<dt><dfn>start</dfn>
557557
<dd>
558558
Start alignment of this box's <a>scroll snap area</a>
559-
within the <a>scroll container</a>'s <a>snap viewport</a>
559+
within the <a>scroll container</a>'s <a>snap window</a>
560560
is a valid <a>snap position</a>.
561561

562562
<dt><dfn>end</dfn>
563563
<dd>
564564
End alignment of this box's <a>scroll snap area</a>
565-
within the <a>scroll container</a>'s <a>snap viewport</a>
565+
within the <a>scroll container</a>'s <a>snap window</a>
566566
is a valid <a>snap position</a>.
567567

568568
<dt><dfn>center</dfn>
569569
<dd>
570570
Center alignment of this box's <a>scroll snap area</a>
571-
within the <a>scroll container</a>'s <a>snap viewport</a>
571+
within the <a>scroll container</a>'s <a>snap window</a>
572572
is a valid <a>snap position</a>.
573573
</dl>
574574

@@ -608,11 +608,11 @@ Scoping Valid Snap Positions to Visible Boxes</h4>
608608
Since the purpose of scroll snapping is to align content within the viewport
609609
for optimal viewing:
610610
in all cases, the specified alignment creates a valid <a>snap position</a>
611-
only if at least part of the <a>snap area</a> is within the <a>snap viewport</a>.
612-
For example, a <a>snap area</a> is top-aligned to the <a>snap viewport</a>
613-
if its top edge is coincident with the <a>snap viewport</a>’s top edge;
611+
only if at least part of the <a>snap area</a> is within the <a>snap window</a>.
612+
For example, a <a>snap area</a> is top-aligned to the <a>snap window</a>
613+
if its top edge is coincident with the <a>snap window</a>’s top edge;
614614
however, this alignment is nonetheless not a valid <a>snap position</a>
615-
if the entire <a>snap area</a> is outside the <a>snap viewport</a>.
615+
if the entire <a>snap area</a> is outside the <a>snap window</a>.
616616

617617
<details class="note">
618618
<summary>Why limit snapping to only when the element is visible?</summary>
@@ -630,9 +630,9 @@ Scoping Valid Snap Positions to Visible Boxes</h4>
630630
<h4 id="snap-overflow">
631631
Snapping Boxes that Overflow the Scrollport</h4>
632632

633-
If the <a>snap area</a> is larger than the <a>snap viewport</a> in a particular axis,
634-
and there are no other <a>snap areas</a> within the <a>snap viewport</a>,
635-
then any scroll position in which the <a>snap area</a> covers the <a>snap viewport</a>
633+
If the <a>snap area</a> is larger than the <a>snap window</a> in a particular axis,
634+
and there are no other <a>snap areas</a> within the <a>snap window</a>,
635+
then any scroll position in which the <a>snap area</a> covers the <a>snap window</a>
636636
is a valid <a>snap position</a> in that axis.
637637
The UA may use the specified alignment as a more precise target
638638
for certain scroll operations (e.g. inertial scrolling or explicit paging).
@@ -644,7 +644,7 @@ Snapping Boxes that Overflow the Scrollport</h4>
644644
but if the item happens to be larger than your viewport,
645645
you want to be able to scroll around the whole thing once you're over it.
646646

647-
Since the <a>snap area</a> is larger than the <a>snap viewport</a>,
647+
Since the <a>snap area</a> is larger than the <a>snap window</a>,
648648
while the area fully fills the viewport,
649649
the container can be scrolled arbitrarily and will not try to snap back to its aligned position.
650650
However, if the container is scrolled such that the area
@@ -911,10 +911,10 @@ Choosing Snap Positions {#choosing}
911911
according to the amount of other-axis scrolling they would cause.
912912

913913
* <a>Snap positions</a> should be ignored if their elements are far outside of the “corridor”
914-
that the <a>snap viewport</a> defines as it moves through the <a>scrollable area</a>
914+
that the <a>snap window</a> defines as it moves through the <a>scrollable area</a>
915915
during an <a>inertial scroll</a>,
916916
or a hypothetical “corridor” in the direction of a <a>directional scroll</a>,
917-
or the <a>snap viewport</a> after an <a>explicit scroll</a>.
917+
or the <a>snap window</a> after an <a>explicit scroll</a>.
918918
(This is to prevent a far-offscreen element
919919
from having difficult-to-understand effects
920920
on the scroll position.)
@@ -1055,7 +1055,7 @@ Physical Longhands for 'scroll-snap-padding' {#padding-longhands-physical}
10551055

10561056
These <a>longhands</a> of 'scroll-snap-padding' specify
10571057
the top, right, bottom, and left
1058-
edges of the <a>snap viewport</a>,
1058+
edges of the <a>snap window</a>,
10591059
respectively.
10601060

10611061
Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
@@ -1074,7 +1074,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
10741074

10751075
These <a>longhands</a> of 'scroll-snap-padding' specify
10761076
the block-start, inline-start, block-end, and inline-end
1077-
edges of the <a>snap viewport</a>,
1077+
edges of the <a>snap window</a>,
10781078
respectively.
10791079

10801080
<pre class="propdef">
@@ -1092,7 +1092,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
10921092
and 'scroll-snap-margin-inline-start' + 'scroll-snap-margin-inline-end'
10931093
are <a>longhands</a> of 'scroll-snap-padding', and
10941094
specify the block-axis and inline-axis
1095-
edges of the <a>snap viewport</a>,
1095+
edges of the <a>snap window</a>,
10961096
respectively.
10971097
If two values are specified, the first gives the start value
10981098
and the second gives the end value.

0 commit comments

Comments
 (0)