From 40b30fe918e1262c71386cd123e66a48ffaa65f5 Mon Sep 17 00:00:00 2001
From: David A <66635890+DavMila@users.noreply.github.com>
Date: Mon, 16 Dec 2024 14:50:32 -0500
Subject: [PATCH] [css-scroll-snap-2] Rename scroll-start-target to
scroll-initial-target (#11360)
In line the CSS working group's resolution[1], this renames the
"scroll-start-target" property to "scroll-initial-target" and replaces
its keyword "auto" with "nearest."
[1] https://github.com/w3c/csswg-drafts/issues/11173#issuecomment-2536659205
---
css-scroll-snap-2/Overview.bs | 30 +++++++++++++++++-------------
1 file changed, 17 insertions(+), 13 deletions(-)
diff --git a/css-scroll-snap-2/Overview.bs b/css-scroll-snap-2/Overview.bs
index 1f4633c4b07..45b4fe44e4c 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.
+
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
-
+
- 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.
-