Skip to content

Commit 144d5e3

Browse files
committed
[css-snappoints] More rewording, and regen html
1 parent 7051182 commit 144d5e3

File tree

2 files changed

+58
-46
lines changed

2 files changed

+58
-46
lines changed

css-snappoints/Overview.bs

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -277,7 +277,7 @@ Scroll Snapping Rules: the 'scroll-snap-type' property {#scroll-snap-type}
277277

278278
<dt><dfn>mandatory</dfn>
279279
<dd>
280-
If specified on a <a>scroll container</a>, the <a>scroll container</a> is required to be <a>snapped</a> to a snap position when there are no active scrolling operations. If a reachable snap position exists then the scroll container must <a>snap</a> at the termination of a scroll. If no reachable snap position exists then no <a>snapping</a> occurs.
280+
If specified on a <a>scroll container</a>, the <a>scroll container</a> is required to be <a>snapped</a> to a snap position when there are no active scrolling operations. If a reachable snap position exists then the scroll container must <a>snap</a> at the termination of a scroll (if none exist then no <a>snapping</a> occurs).
281281

282282
If the content changes such that the scroll container would no longer be <a>snapped</a> (e.g. content is added, moved, deleted, resized) to the same snap position it was snapped to before the content change, the scroll container must be re-snapped. If the same snap position it was snapped to before the content change still exists (e.g. its associated element was not deleted) and is reachable, the scroll container must be re-snapped to that same snap position after the content change.
283283

@@ -362,7 +362,7 @@ Scroll Snapping Rules: the 'scroll-snap-type' property {#scroll-snap-type}
362362
-->
363363

364364
Scroll Snapport: the 'scroll-snap-padding' property {#scroll-snap-padding}
365-
-------------------------------------------------------------------
365+
--------------------------------------------------------------------------
366366

367367
<pre class="propdef">
368368
Name: scroll-snap-padding
@@ -376,7 +376,7 @@ Scroll Snapport: the 'scroll-snap-padding' property {#scroll-snap-padding}
376376
Animatable: as length, percentage, or calc
377377
</pre>
378378

379-
The 'scroll-snap-padding' property defines the <dfn local-lt="snapport">scroll snapport</dfn>, a region inset from the scrollport 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 scrollport.
379+
The 'scroll-snap-padding' property defines the <dfn local-lt="snapport">scroll snapport</dfn>, the area of the scrollport that is used as the <a>alignment container</a> for the <a>scroll snap areas</a> when calculating <a>snap positions</a>. Values are interpreted as for 'padding', and specify inward offsets from each edge of the scrollport.
380380

381381
<div class="example">
382382
In this example, scroll-snap-padding is used to center slideshow images within the portion of the scrollport that is not obscured by a fixed-position toolbar.
@@ -475,22 +475,33 @@ Scroll Snapping Alignment: the 'scroll-snap-align' property {#scroll-snap-align}
475475

476476
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).
477477

478+
Values are defined as follows:
479+
478480
<dl dfn-type="value" dfn-for="scroll-snap-align">
479481
<dt><dfn>none</dfn>
480482
<dd>
481483
This box does not define a <a>snap position</a> in the specified axis.
482484

483485
<dt><dfn>start</dfn>
484486
<dd>
485-
The scroll position 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.
487+
Start alignment of this box's <a>scroll snap area</a>
488+
within the <a>scroll container</a>'s <a>snapport</a>
489+
is a <a>snap position</a>
490+
in the specified axis.
486491

487492
<dt><dfn>end</dfn>
488493
<dd>
489-
The scroll position 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.
494+
End alignment of this box's <a>scroll snap area</a>
495+
within the <a>scroll container</a>'s <a>snapport</a>
496+
is a <a>snap position</a>
497+
in the specified axis.
490498

491499
<dt><dfn>center</dfn>
492500
<dd>
493-
The scroll position 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.
501+
Center alignment of this box's <a>scroll snap area</a>
502+
within the <a>scroll container</a>'s <a>snapport</a>
503+
is a <a>snap position</a>
504+
in the specified axis.
494505
</dl>
495506

496507
<!--
@@ -559,7 +570,7 @@ Axis vs Point-Snapping {#snap-dimensions}
559570
-->
560571

561572
Appendix A: Longhands {#longhands}
562-
=====================
573+
==================================
563574

564575
Physical Longhands for 'scroll-snap-padding' {#padding-longhands-physical}
565576
--------------------------------------------------------------------------
@@ -612,7 +623,7 @@ Flow-relative Longhands for 'scroll-snap-padding' {#padding-longhands-logical}
612623
If two values are specified, the first gives the start value and the second gives the end value.
613624

614625
Physical Longhands for 'scroll-snap-margin' {#margin-longhands-physical}
615-
-----------------------------------------------------------------------
626+
-------------------------------------------------------------------------
616627

617628
<pre class="propdef">
618629
Name: scroll-snap-margin-top, scroll-snap-margin-right, scroll-snap-margin-bottom, scroll-snap-margin-left
@@ -629,7 +640,7 @@ Physical Longhands for 'scroll-snap-margin' {#margin-longhands-physical}
629640
These <a>longhands</a> of 'scroll-snap-margin' specify the top, right, bottom, and left edges of the <a>scroll snap area</a>, respectively.
630641

631642
Flow-relative Longhands for 'scroll-snap-margin' {#margin-longhands-logical}
632-
---------------------------------------------------------------------------
643+
-----------------------------------------------------------------------------
633644

634645
<pre class="propdef">
635646
Name: scroll-snap-margin-block-start, scroll-snap-margin-inline-start, scroll-snap-margin-block-end, scroll-snap-margin-inline-end

0 commit comments

Comments
 (0)