Skip to content

Commit 71da687

Browse files
committed
[css-snappoints] 'snap alignment container' -> 'snapport' per WG resolution 5/4/2016
1 parent f4bfe3a commit 71da687

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

css-snappoints/Overview.bs

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ Motivating Examples {#examples}
113113

114114
<figcaption>
115115
The layout of the scroll container's contents in the example.
116-
The snap alignment container is represented by the red rectangle, and the snap area is represented by the yellow rectangle. Since the scroll-snap-align is "center" in the X axis, a snap position is established at each scroll offset which aligns the X-center of the snap alignment container (represented by a red dotted line) with the X-center of a snap area (represented by a yellow dotted line).
116+
The snapport is represented by the red rectangle, and the snap area is represented by the yellow rectangle. Since the scroll-snap-align is "center" in the X axis, a snap position is established at each scroll offset which aligns the X-center of the snapport (represented by a red dotted line) with the X-center of a snap area (represented by a yellow dotted line).
117117
</figcaption>
118118
</figure>
119119
</div>
@@ -158,7 +158,7 @@ Motivating Examples {#examples}
158158

159159
<figcaption>
160160
The layout of the scroll container's contents in the example.
161-
The snap alignment container is represented by the red rectangle (inset from the top by 100px due to the scroll-snap-padding), and the snap area is represented by the yellow rectangle. Since the scroll-snap-align is "start" in the Y axis, a snap position is established at each scroll offset which aligns the Y-start of the snap alignment container (represented by a red dotted line) with the Y-start of a snap area (represented by a yellow dotted line).
161+
The snapport is represented by the red rectangle (inset from the top by 100px due to the scroll-snap-padding), and the snap area is represented by the yellow rectangle. Since the scroll-snap-align is "start" in the Y axis, a snap position is established at each scroll offset which aligns the Y-start of the snapport (represented by a red dotted line) with the Y-start of a snap area (represented by a yellow dotted line).
162162
</figcaption>
163163
</figure>
164164
</div>
@@ -187,7 +187,7 @@ Overview {#overview}
187187
<a>Snap positions</a> can be specified
188188
as a particular alignment ('scroll-snap-align')
189189
of an element's <a>scroll snap area</a> ('scroll-snap-margin', defaulting to its border box)
190-
within the <a>scroll container</a>’s <a>snap alignment container</a>
190+
within the <a>scroll container</a>’s <a>snapport</a>
191191
(its visual viewport, as reduced by its 'scroll-snap-padding').
192192
This is conceptually equivalent to specifying the alignment of
193193
an <a>alignment subject</a> within an <a>alignment container</a>.
@@ -216,9 +216,9 @@ Definitions {#definitions}
216216
<dd>
217217
An element which provides a scrolling user interface as described in [[!CSS21]], particularly in the section on overflow.
218218

219-
<dt><dfn export>snap alignment container</dfn>
219+
<dt><dfn export>snapport</dfn>
220220
<dd>
221-
A scroll container's snap alignment container is the rectangle obtained by reducing its visual viewport by its 'scroll-snap-padding'.
221+
A scroll container's snapport is the rectangle obtained by reducing its visual viewport by its 'scroll-snap-padding'.
222222

223223
Issue: Better name for this concept?
224224

@@ -325,7 +325,7 @@ Snapport: the 'scroll-snap-padding' property {#scroll-snap-padding}
325325
Animatable: as length, percentage, or calc
326326
</pre>
327327

328-
The 'scroll-snap-padding' property defines the <a>snap alignment container</a>, a region inset from the visual viewport of a <a>scroll container</a> used in calculating its <a>snap positions</a>. The snap alignment container is used as the alignment container when calculating <a>snap positions</a>. Values are interpreted as for 'padding', and specify inward offsets from each edge of the visual viewport.
328+
The 'scroll-snap-padding' property defines the <a>snapport</a>, a region inset from the visual viewport of a <a>scroll container</a> used in calculating its <a>snap positions</a>. The snapport is used as the alignment container when calculating <a>snap positions</a>. Values are interpreted as for 'padding', and specify inward offsets from each edge of the visual viewport.
329329

330330
<div class="example">
331331
In this example, scroll-snap-padding is used to center slideshow images within the portion of the viewport that is not obscured by a fixed-position toolbar.
@@ -419,7 +419,7 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
419419
Animatable: no
420420
</pre>
421421

422-
The 'scroll-snap-align' property specifies how an element's scroll snap area should align with its ancestor scroll container's snap alignment container. The two values specify the snapping behavior in the x and y axes, respectively. If only one value is specified, the second value defaults to the same value.
422+
The 'scroll-snap-align' property specifies how an element's scroll snap area should align with its ancestor scroll container's snapport. The two values specify the snapping behavior in the x and y axes, respectively. If only one value is specified, the second value defaults to the same value.
423423

424424
Issue: Should this be x/y axes, or inline/block? Starting with x/y axes for consistency with padding/area, otherwise a writing mode change would result in a axis mismatch (since padding is physical by default).
425425

@@ -469,7 +469,7 @@ Physical Longhands for 'scroll-snap-padding' {#padding-longhands-physical}
469469
Animatable: as length, percentage, or calc
470470
</pre>
471471

472-
These <a>longhands</a> of 'scroll-snap-padding' specify the top, right, bottom, and left edges of the <a>snap alignment container</a>, respectively.
472+
These <a>longhands</a> of 'scroll-snap-padding' specify the top, right, bottom, and left edges of the <a>snapport</a>, respectively.
473473

474474
Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
475475
-------------------------------------------------------------------------------
@@ -486,7 +486,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
486486
Animatable: as length, percentage, or calc
487487
</pre>
488488

489-
These <a>longhands</a> of 'scroll-snap-padding' specify the block-start, inline-start, block-end, and inline-end edges of the <a>snap alignment container</a>, respectively.
489+
These <a>longhands</a> of 'scroll-snap-padding' specify the block-start, inline-start, block-end, and inline-end edges of the <a>snapport</a>, respectively.
490490

491491
<pre class="propdef">
492492
Name: scroll-snap-padding-block, scroll-snap-padding-inline
@@ -500,7 +500,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
500500
Animatable: as length, percentage, or calc
501501
</pre>
502502

503-
These <a>shorthands</a> of 'scroll-snap-padding-block-start' + 'scroll-snap-padding-block-end' and 'scroll-snap-padding-inline-start' + 'scroll-snap-padding-inline-end' are <a>longhands</a> of 'scroll-snap-padding', and specify the block-axis and inline-axis edges of the <a>snap alignment container</a>, respectively.
503+
These <a>shorthands</a> of 'scroll-snap-padding-block-start' + 'scroll-snap-padding-block-end' and 'scroll-snap-padding-inline-start' + 'scroll-snap-padding-inline-end' are <a>longhands</a> of 'scroll-snap-padding', and specify the block-axis and inline-axis edges of the <a>snapport</a>, respectively.
504504

505505
If two values are specified, the first gives the start value and the second gives the end value.
506506

0 commit comments

Comments
 (0)