Skip to content

Commit a2be3b3

Browse files
tabatkinstabatkins
committed
[css-scroll-snap] Resolve issue 6 by removing the section, now that a version with it has been published for posterity.
1 parent b6740e0 commit a2be3b3

File tree

1 file changed

+6
-79
lines changed

1 file changed

+6
-79
lines changed

‎css-scroll-snap/Overview.bs‎

Lines changed: 6 additions & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -299,35 +299,29 @@ Scroll Snapping Rules: the 'scroll-snap-type' property {#scroll-snap-type}
299299
<dl dfn-type=value dfn-for="scroll-snap-type">
300300
<dt><dfn>x</dfn>
301301
<dd>
302-
The <a>scroll container</a> <a>axis-snaps</a> to <a>snap positions</a>
302+
The <a>scroll container</a> <a>snaps</a> to <a>snap positions</a>
303303
in its horizontal axis only.
304304

305305
<dt><dfn>y</dfn>
306306
<dd>
307-
The <a>scroll container</a> <a>axis-snaps</a> to <a>snap positions</a>
307+
The <a>scroll container</a> <a>snaps</a> to <a>snap positions</a>
308308
in its vertical axis only.
309309

310310
<dt><dfn>block</dfn>
311311
<dd>
312-
The <a>scroll container</a> <a>axis-snaps</a> to <a>snap positions</a>
312+
The <a>scroll container</a> <a>snaps</a> to <a>snap positions</a>
313313
in its block axis only.
314314

315315
<dt><dfn>inline</dfn>
316316
<dd>
317-
The <a>scroll container</a> <a>axis-snaps</a> to <a>snap positions</a>
317+
The <a>scroll container</a> <a>snaps</a> to <a>snap positions</a>
318318
in its inline axis only.
319319

320320
<dt><dfn>both</dfn>
321321
<dd>
322-
The <a>scroll container</a> <a>axis-snaps</a> to <a>snap positions</a>
322+
The <a>scroll container</a> <a>snaps</a> to <a>snap positions</a>
323323
in both of its axes independently
324324
(potentially snapping to different elements in each axis).
325-
326-
<dt><dfn>point</dfn>
327-
<dd>
328-
The <a>scroll container</a> <a>point-snaps</a> to <a>snap positions</a> in both axes simultaneously,
329-
treating each element’s <a>snap position</a> as a single 2D position
330-
(rather than potentially snapping to different elements in each axis).
331325
</dl>
332326

333327
Advisement:
@@ -709,61 +703,6 @@ Types of Scrolling Methods {#scroll-types}
709703
An <a>axis-locked</a> scroll is bound to only scroll along that axis.
710704
This prevents less-precise input mechanisms from drifting in the non-primary axis.
711705

712-
<!--
713-
██ ████████ ███████ ████████
714-
████ ██ ██ ██ ██ ██ ██
715-
██ ██ ██ ██ ██ ██
716-
██ ██ ██ ███████ ██ ██
717-
██ ██ ██ ██ ██ ██
718-
██ ██ ██ ██ ██ ██
719-
██████ ████████ █████████ ████████
720-
-->
721-
722-
Axis vs Point-Snapping {#snap-dimensions}
723-
-----------------------------------------
724-
725-
Issue: This feature is planned to be removed in the next publication
726-
in order to reduce the feature-set of Level 1.
727-
It is included here for future reference in defining Level 2.
728-
729-
There are two distinct <dfn lt="snap behavior|snapping behavior">snapping behaviors</dfn> that a <a>scroll container</a> might engage in:
730-
731-
: <dfn export local-lt="axis" lt="axis-snapping|axis-snap">axis-snapping</dfn>
732-
:: If a <a>scroll container</a> is <a>axis-snapping</a>,
733-
its descendants indicate a desired scroll position
734-
in each axis of the <a>scroll container</a> independently,
735-
with no dependent preference for what the other axis’s scroll position should be.
736-
737-
Note: This is the “default” type of <a>snap behavior</a>
738-
that most <a>scroll containers</a> will want to use,
739-
and so the ''scroll-snap-type'' property intentionally defaults to it.
740-
741-
Note: An element in an <a>axis-snapping</a> <a>scroll container</a>
742-
can declare two <a>snap positions</a>,
743-
one in each axis.
744-
If one of the element’s <a>snap positions</a> is chosen in one axis,
745-
this has no bearing on the other dimension’s <a>snap position</a>--
746-
it might be chosen,
747-
or a different element’s <a>snap position</a> might be chosen for that axis,
748-
or that axis might not snap at all.
749-
750-
: <dfn export local-lt="point" lt="point-snapping|point-snap">point-snapping</dfn>
751-
:: If a <a>scroll container</a> is <a>point-snapping</a>,
752-
its descendants indicate a desired scroll position
753-
in both axes of the <a>scroll container</a> simultaneously--
754-
in other words,
755-
some point in the descendant must be aligned to a corresponding point in the <a>scroll container</a>.
756-
757-
This type of <a>snapping behavior</a> is intended for “two-dimensional” panning-type layouts,
758-
such as cities on a map
759-
(using ''proximity'' 2D snap positions to snap a city to the center of the display when it gets close),
760-
or a tiled image gallery
761-
(using ''mandatory'' 2D snap positions to force each image to be centered on the screen).
762-
In both of these cases,
763-
it would look weird if the horizontal scrolling was aligned to one element
764-
while the vertical was aligned to a different element
765-
(which is the behavior you’d get if the <a>scroll container</a> was <a>axis-snapping</a>).
766-
767706
<!--
768707
██████ ██ ██ ███████ ███████ ██████ ████ ██ ██ ██████
769708
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ ██ ██
@@ -789,23 +728,11 @@ Choosing Snap Positions {#choosing}
789728
and the final snapped scroll position,
790729
subject to the additional constraints listed in this section.
791730

792-
* <a>Point-snapping</a> is all-or-nothing;
793-
if the <a>snap position</a> of an element is chosen to align to,
794-
the <a>scroll container</a> must set its scroll position
795-
according to the element’s <a>snap positions</a> in <em>both</em> axises;
796-
the <a>scroll container</a> <em>must not</em> “partially align” to the element
797-
by taking its <a>snap position</a> in one axis
798-
and aligning the other axis according to something else.
799-
800-
* If a scroll is <a>axis-locked</a> and the <a>scroll container</a> is <a>axis-snapping</a>,
731+
* If a scroll is <a>axis-locked</a>,
801732
any <a>snap positions</a> in the other axis should be ignored
802733
during the scroll.
803734
(However, <a>snap positions</a> in the other axis can still effect the final scroll position.)
804735

805-
If a scroll is <a>axis-locked</a> and the <a>scroll container</a> is <a>point-snapping</a>,
806-
<a>snap positions</a> should be penalized in the selection process
807-
according to the amount of other-axis scrolling they would cause.
808-
809736
* In order to prevent a far-offscreen element
810737
from having difficult-to-understand effects
811738
on the scroll position,

0 commit comments

Comments
 (0)