Skip to content

Commit 331155d

Browse files
committed
[css-snappoints] Adding definition of snap position, and rephrasing in terms of that. Removing resolved issues. No functional changes.
1 parent ffdca8c commit 331155d

File tree

1 file changed

+8
-12
lines changed

1 file changed

+8
-12
lines changed

css-snappoints/Overview.src.html

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -162,11 +162,15 @@ <h2 id="definitions">Definitions</h2>
162162
<dt><dfn export>scroll container</dfn>
163163
<dd>
164164
An element which provides a scrolling user interface as described in [[!CSS21]], particularly in the section on overflow.
165+
166+
<dt><dfn export>snap position</dfn>
167+
<dd>
168+
For a scroll container, a particular value for its scroll offset is a snap position if when scrolled to that offset the visual viewport of the scroll container would align with a descendent element in the manner specified by the scroll snap properties.
165169
</dl>
166170

167171
<h2 id="scroll-snap-type">Scroll Snap Types: the 'scroll-snap-type' property</h2>
168172

169-
The ''scroll-snap-type'' property is used to define how strictly snap points are enforced on the <a>scroll container</a>, if any are present. It defines how and when snap points are enforced on the visual viewport of the scroll container it is applied to in order to adjust scroll offset. It intentionally does not specify nor mandate any precise animations or physics used to enforce those snap points; this is left up to the user agent.
173+
The ''scroll-snap-type'' property is used to define how strictly a <a>scroll container's</a> visual viewport should rest on <a>snap positions</a>. It intentionally does not specify nor mandate any precise animations or physics used to enforce those snap points; this is left up to the user agent.
170174

171175
<pre class='propdef'>
172176
Name: scroll-snap-type
@@ -183,25 +187,17 @@ <h2 id="scroll-snap-type">Scroll Snap Types: the 'scroll-snap-type' property</h2
183187
<dl dfn-type="value" dfn-for="scroll-snap-type">
184188
<dt><dfn>none</dfn>
185189
<dd>
186-
The visual viewport of this <a>scroll container</a> must ignore snap points, if any, when scrolled.
190+
The visual viewport of this <a>scroll container</a> must ignore snap positions.
187191

188192
<dt><dfn>mandatory</dfn>
189193
<dd>
190-
The visual viewport of this <a>scroll container</a> is guaranteed to rest on a snap point when there are no active scrolling operations. That is, it must come to rest on a snap point at the termination of a scroll, if a valid, reachable snap point exists (if no valid, reachable snap point exists then no snapping occurs). If the content changes such that the visual viewport would no longer rest on a snap point (e.g. content is added, moved, deleted, resized), the scroll offset must be modified to maintain this guarantee.
194+
The visual viewport of this <a>scroll container</a> is guaranteed to rest on a snap position when there are no active scrolling operations. That is, it must come to rest on a snap position at the termination of a scroll, if a valid, reachable snap position exists. If no valid, reachable snap position exists then no snapping occurs. If the content changes such that the visual viewport would no longer rest on a snap position (e.g. content is added, moved, deleted, resized), the scroll offset must be modified to maintain this guarantee.
191195

192196
<dt><dfn>proximity</dfn>
193197
<dd>
194-
The visual viewport of this <a>scroll container</a> may come to rest on a snap point at the termination of a scroll at the discretion of the UA given the parameters of the scroll. If the content changes such that the visual viewport would no longer rest on a snap point (e.g. content is added, moved, deleted, resized), the scroll offset may be modified to maintain this guarantee.
198+
The visual viewport of this <a>scroll container</a> may come to rest on a snap position at the termination of a scroll at the discretion of the UA given the parameters of the scroll. If the content changes such that the visual viewport would no longer rest on a snap position (e.g. content is added, moved, deleted, resized), the scroll offset may be modified to maintain this guarantee.
195199
</dl>
196200

197-
<div class="issue">
198-
Describe the guarantee as an invariant for better clarity. Include edge case behavior such as mandatory snap points when there is no satisfiable snap point.
199-
</div>
200-
201-
<div class="issue">
202-
Should there be a way to specify that either end of the scrollable content should have a snap point?
203-
</div>
204-
205201
<h2 id="scroll-snap-destination">Scroll Snap Destination: the 'scroll-snap-destination' property</h2>
206202

207203
The 'scroll-snap-destination' property is used to define the x and y coordinate within the <a>scroll container's</a> visual viewport

0 commit comments

Comments
 (0)