Skip to content

Commit 00e21f3

Browse files
committed
[css-snappoints] Margin -> area
1 parent 01046b5 commit 00e21f3

File tree

1 file changed

+23
-23
lines changed

1 file changed

+23
-23
lines changed

css-snappoints/Overview.bs

Lines changed: 23 additions & 23 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 margin 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 margin (represented by a yellow dotted line).
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).
117117
</figcaption>
118118
</figure>
119119
</div>
@@ -135,7 +135,7 @@ Motivating Examples {#examples}
135135
width: 500px;
136136
overflow-x: hidden;
137137
overflow-y: auto;
138-
/* Specifies that each element's snap margin should
138+
/* Specifies that each element's snap area should
139139
align with a 100px offset from the top edge. */
140140
scroll-snap-padding: 100px 0 0;
141141
/* Encourages scrolling to end at a snap position when the
@@ -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 margin 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 margin (represented by a yellow dotted line).
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).
162162
</figcaption>
163163
</figure>
164164
</div>
@@ -186,7 +186,7 @@ Overview {#overview}
186186

187187
<a>Snap positions</a> can be specified
188188
as a particular alignment ('scroll-snap-align')
189-
of an element's <a>scroll snap margin</a> ('scroll-snap-margin', defaulting to its border box)
189+
of an element's <a>scroll snap area</a> ('scroll-snap-margin', defaulting to its border box)
190190
within the <a>scroll container</a>’s <a>snap alignment container</a>
191191
(its visual viewport, as reduced by its 'scroll-snap-padding').
192192
This is conceptually equivalent to specifying the alignment of
@@ -222,9 +222,9 @@ Definitions {#definitions}
222222

223223
Issue: Better name for this concept?
224224

225-
<dt><dfn lt="scroll snap margin" local-lt="snap margin" export>snap margin</dfn>
225+
<dt><dfn lt="scroll snap area" local-lt="snap area" export>snap area</dfn>
226226
<dd>
227-
An element's snap margin is the rectangle obtained by expanding its border box by its 'scroll-snap-margin'.
227+
An element's snap area is the rectangle obtained by expanding its border box by its 'scroll-snap-margin'.
228228

229229
<dt><dfn lt="scroll snap position" local-lt="snap position" export>snap position</dfn>
230230
<dd>
@@ -355,16 +355,16 @@ Properties on the elements {#properties-on-the-elements}
355355
========================================================
356356

357357
<!--
358-
██ ██ ███ ████████ ██████ ████ ██ ██
359-
███ ███ ██ ██ ██ ██ ██ ██ ██ ███ ██
360-
████ ████ ██ ██ ██ ██ ██ ██ ████ ██
361-
██ ███ ██ ██ ██ ████████ ██ ████ ██ ██ ██ ██
362-
██ ██ █████████ ██ ██ ██ ██ ██ ██ ████
363-
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
364-
██ ██ ██ ██ ██ ██ ██████ ████ ██ ██
358+
███ ████████ ████████ ███
359+
██ ██ ██ ██ ██ ██ ██
360+
██ ██ ██ ██ ██ ██ ██
361+
██ ██ ████████ ██████ ██ ██
362+
█████████ ██ ██ ██ █████████
363+
██ ██ ██ ██ ██ ██ ██
364+
██ ██ ██ ██ ████████ ██ ██
365365
-->
366366

367-
Scroll Snap Margin: the 'scroll-snap-margin' property {#scroll-snap-margin}
367+
Scroll Snap Area: the 'scroll-snap-margin' property {#scroll-snap-margin}
368368
---------------------------------------------------------------------------
369369

370370
<pre class="propdef">
@@ -379,7 +379,7 @@ Scroll Snap Margin: the 'scroll-snap-margin' property {#scroll-snap-margin}
379379
Animatable: as length
380380
</pre>
381381

382-
The 'scroll-snap-margin' property defines the <a>scroll snap margin</a> on elements within a <a>scroll container</a>, used in calculating <a>snap positions</a> for that scroll container.
382+
The 'scroll-snap-margin' property defines the <a>scroll snap area</a> on elements within a <a>scroll container</a>, used in calculating <a>snap positions</a> for that scroll container.
383383

384384
The 'scroll-snap-margin' property defines
385385
the <dfn lt="scroll snap area" local-lt="snap area">scroll snap area</dfn>
@@ -390,7 +390,7 @@ Scroll Snap Margin: the 'scroll-snap-margin' property {#scroll-snap-margin}
390390
plus the specified outsets,
391391
axis-aligned in the <a>scroll container’s</a> coordinate space.
392392

393-
Note: This ensures that the <a>scroll snap margin</a> is always rectangular and axis-aligned to the <a>scroll container's</a> coordinate space.
393+
Note: This ensures that the <a>scroll snap area</a> is always rectangular and axis-aligned to the <a>scroll container's</a> coordinate space.
394394

395395
This property is a <a>shorthand property</a> that sets all of the <a href="#longhands"><css>scroll-snap-margin-*</css> longhands</a> in one declaration.
396396

@@ -419,7 +419,7 @@ Scroll Snap 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 margin 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 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.
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

@@ -430,15 +430,15 @@ Scroll Snap Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
430430

431431
<dt><dfn>start</dfn>
432432
<dd>
433-
The scroll offset which aligns the start edge of this box's scroll snap margin with the start edge of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
433+
The scroll offset which aligns the start edge of this box's scroll snap area with the start edge of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
434434

435435
<dt><dfn>end</dfn>
436436
<dd>
437-
The scroll offset which aligns the end edge of this box's scroll snap margin with the end edge of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
437+
The scroll offset which aligns the end edge of this box's scroll snap area with the end edge of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
438438

439439
<dt><dfn>center</dfn>
440440
<dd>
441-
The scroll offset which aligns the center of this box's scroll snap margin with the center of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
441+
The scroll offset which aligns the center of this box's scroll snap area with the center of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
442442
</dl>
443443

444444
<!--
@@ -519,7 +519,7 @@ Physical Longhands for 'scroll-snap-margin' {#margin-longhands-physical}
519519
Animatable: as length
520520
</pre>
521521

522-
These <a>longhands</a> of 'scroll-snap-margin' specify the top, right, bottom, and left edges of the <a>scroll snap margin</a>, respectively.
522+
These <a>longhands</a> of 'scroll-snap-margin' specify the top, right, bottom, and left edges of the <a>scroll snap area</a>, respectively.
523523

524524
Flow-relative Longhands for 'scroll-snap-margin' {#margin-longhands-logical}
525525
---------------------------------------------------------------------------
@@ -536,7 +536,7 @@ Flow-relative Longhands for 'scroll-snap-margin' {#margin-longhands-logical}
536536
Animatable: as length
537537
</pre>
538538

539-
These <a>longhands</a> of 'scroll-snap-margin' specify the block-start, inline-start, block-end, and inline-end edges of the <a>scroll snap margin</a>, respectively.
539+
These <a>longhands</a> of 'scroll-snap-margin' specify the block-start, inline-start, block-end, and inline-end edges of the <a>scroll snap area</a>, respectively.
540540

541541
<pre class="propdef">
542542
Name: scroll-snap-margin-block, scroll-snap-margin-inline
@@ -550,7 +550,7 @@ Flow-relative Longhands for 'scroll-snap-margin' {#margin-longhands-logical}
550550
Animatable: as length
551551
</pre>
552552

553-
These <a>shorthands</a> of 'scroll-snap-margin-block-start' + 'scroll-snap-margin-block-end' and 'scroll-snap-margin-inline-start' + 'scroll-snap-margin-inline-end' are <a>longhands</a> of 'scroll-snap-margin', and specify the block-axis and inline-axis edges of the <a>scroll snap margin</a>, respectively.
553+
These <a>shorthands</a> of 'scroll-snap-margin-block-start' + 'scroll-snap-margin-block-end' and 'scroll-snap-margin-inline-start' + 'scroll-snap-margin-inline-end' are <a>longhands</a> of 'scroll-snap-margin', and specify the block-axis and inline-axis edges of the <a>scroll snap area</a>, respectively.
554554

555555
If two values are specified, the first gives the start value and the second gives the end value.
556556

0 commit comments

Comments
 (0)