8000 [css-scroll-snap-2] Rename scroll-start-target to scroll-initial-targ… · w3c/csswg-drafts@40b30fe · GitHub
Skip to content

Commit 40b30fe

Browse files
authored
[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] #11173 (comment)
1 parent b1b87f6 commit 40b30fe

File tree

1 file changed

+17
-13
lines changed

1 file changed

+17
-13
lines changed

css-scroll-snap-2/Overview.bs

+17-13
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ Motivating Examples {#examples}
8080
overflow-inline: auto;
8181
}
8282
.carousel .origin {
83-
scroll-start-target: auto;
83+
scroll-initial-target: nearest;
8484
}
8585
</pre>
8686

@@ -103,7 +103,7 @@ Motivating Examples {#examples}
103103
}
104104

105105
main {
106-
scroll-start-target: auto;
106+
scroll-initial-target: nearest;
107107
}
108108
</pre>
109109

@@ -131,15 +131,19 @@ Motivating Examples {#examples}
131131
Setting Where Scroll Starts {#properties-on-the-scroll-container}
132132
=================================================================
133133

134-
The 'scroll-start-target' property {#scroll-start-target}
134+
The 'scroll-initial-target' property {#scroll-initial-target}
135135
-------------------------------------------
136136

137+
ISSUE(11173): The name "scroll-initial-target" is chosen as the least worst option
138+
which expresses that it should be scrolled to when its scroll container
139+
first shows up on the page. A better name for the property would be very much welcome.
140+
137141
<h4 dfn export id="initial-scroll-target">
138142
Initial scroll target</h4>
139143

140144
The [=initial scroll target=] of a <a>scroll container</a> |scrollcontainer|
141145
is an element or pseudo-element
142-
whose 'scroll-start-target'property is non-''scroll-start-target/none''
146+
whose 'scroll-initial-target'property is non-''scroll-initial-target/none''
143147
and whose nearest <a>scroll container</a> is |scrollcontainer|.
144148
When multiple such elements or pseudo-elements exist,
145149
user-agents should select the one
@@ -163,11 +167,11 @@ Initial scroll target</h4>
163167
</div>
164168

165169

166-
<h4 id="scroll-start-target-propdef">scroll-start-target Property Definition</h4>
170+
<h4 id="scroll-initial-target-propdef">scroll-initial-target Property Definition</h4>
167171

168172
<pre class="propdef">
169-
Name: scroll-start-target
170-
Value: none | auto
173+
Name: scroll-initial-target
174+
Value: none | nearest
171175
Initial: ''none''
172176
Applies to: all elements
173177
Inherited: no
@@ -176,23 +180,23 @@ Initial scroll target</h4>
176180
Animation type: none
177181
</pre>
178182

179-
<dl dfn-type=value dfn-for="scroll-start-target">
183+
<dl dfn-type=value dfn-for="scroll-initial-target">
180184
<dt><dfn>none</dfn>
181185
<dd>The element is not an [=initial scroll target=].
182-
<dt><dfn>auto</dfn>
186+
<dt><dfn>nearest</dfn>
183187
<dd>The element is potentially an [=initial scroll target=]
184188
for its nearest [=scroll container=] ancestor.
185189
</dl>
186190

187-
<h4 id="scroll-start-target-with-place-content">
191+
<h4 id="scroll-initial-target-with-place-content">
188192
Interaction with 'place-content'</h4>
189193

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

195-
<h4 id="scroll-start-target-fragment-navigation">
199+
<h4 id="scroll-initial-target-fragment-navigation">
196200
Post-first layout arrivals</h4>
197201

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

0 commit comments

Comments
 (0)