Skip to content

Commit 579b53f

Browse files
committed
[css-will-change] Specify that we use CI matching against property names. Also add a note that unknown values are fine, since Chrome does this wrong. Fixes #3155.
1 parent 11af8e1 commit 579b53f

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

css-will-change-1/Overview.bs

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -239,7 +239,8 @@ Hinting at Future Behavior: the 'will-change' property</h2>
239239

240240
<dt><dfn><<custom-ident>></dfn>
241241
<dd>
242-
Indicates that the author expects to animate or change the property with the given name on the element in the near future.
242+
If the <<custom-ident>> is an [=ASCII case-insensitive=] match for the name of a built-in CSS property,
243+
it indicates that the author expects to animate or change the property with the given name on the element in the near future.
243244
If the property given is a shorthand,
244245
it indicates the expectation for all the longhands the shorthand expands to.
245246

@@ -260,6 +261,12 @@ Hinting at Future Behavior: the 'will-change' property</h2>
260261
which means that effects that happen through custom properties
261262
do not count for the rules below that are conditioned on any non-initial value of a property causing something.
262263

264+
Note: Specifying a value that's not recognized as a property is fine;
265+
it simply has no effect.
266+
This allows you to safely specify <em>new</em> properties that exist in some user agents
267+
without negatively affecting down-level user agents
268+
that don't know about that property.
269+
263270
<p class='example'>
264271
For example, browsers often handle elements with 'transform' set to a non-initial value very differently from normal elements,
265272
perhaps rendering them to their own “GPU layer”

0 commit comments

Comments
 (0)