diff --git a/css-scroll-snap-2/Overview.bs b/css-scroll-snap-2/Overview.bs index 1f4633c4b07e..45b4fe44e4ca 100644 --- a/css-scroll-snap-2/Overview.bs +++ b/css-scroll-snap-2/Overview.bs @@ -80,7 +80,7 @@ Motivating Examples {#examples} overflow-inline: auto; } .carousel .origin { - scroll-start-target: auto; + scroll-initial-target: nearest; } @@ -103,7 +103,7 @@ Motivating Examples {#examples} } main { - scroll-start-target: auto; + scroll-initial-target: nearest; } @@ -131,15 +131,19 @@ Motivating Examples {#examples} Setting Where Scroll Starts {#properties-on-the-scroll-container} ================================================================= -The 'scroll-start-target' property {#scroll-start-target} +The 'scroll-initial-target' property {#scroll-initial-target} ------------------------------------------- +ISSUE(11173): The name "scroll-initial-target" is chosen as the least worst option +which expresses that it should be scrolled to when its scroll container +first shows up on the page. A better name for the property would be very much welcome. +

Initial scroll target

The [=initial scroll target=] of a scroll container |scrollcontainer| is an element or pseudo-element - whose 'scroll-start-target'property is non-''scroll-start-target/none'' + whose 'scroll-initial-target'property is non-''scroll-initial-target/none'' and whose nearest scroll container is |scrollcontainer|. When multiple such elements or pseudo-elements exist, user-agents should select the one @@ -163,11 +167,11 @@ Initial scroll target -

scroll-start-target Property Definition

+

scroll-initial-target Property Definition

-		Name: scroll-start-target
-		Value: none | auto
+		Name: scroll-initial-target
+		Value: none | nearest
 		Initial: ''none''
 		Applies to: all elements
 		Inherited: no
@@ -176,23 +180,23 @@ Initial scroll target
 		Animation type: none
 	
-
+
none
The element is not an [=initial scroll target=]. -
auto +
nearest
The element is potentially an [=initial scroll target=] for its nearest [=scroll container=] ancestor.
-

+

Interaction with 'place-content'

If a [=scroll container's=] [=initial scroll position=] is potentially set by both a [=content-distribution property=] - and by 'scroll-start-target' on a descendant, - 'scroll-start-target' wins. + and by 'scroll-initial-target' on a descendant, + 'scroll-initial-target' wins. -

+

Post-first layout arrivals

While the document is being [[html#updating-the-document|updated]],