MDN URL

https://developer.mozilla.org/en-US/docs/Web/CSS/revert-layer

What specific section or headline is this issue about?

No response

What information was incorrect, unhelpful, or incomplete?

There is an important distinction between revert-layer and revert that this page does not mention (in fact, it even says that revert-layer works exactly like revert outside of cascade layers, but it's not true): revert-layer preserves presentational hints (see w3c/csswg-drafts#7087) while revert doesn't. This article taught me this.

What did you expect to see?

In the Revert-layer vs. revert section, the following:

However, if the revert-layer keyword is set on a property outside a layer, the value of the property will roll back to the default value established by the user agent's stylesheet (or by user styles, if any exist). So in this scenario, the revert-layer keyword behaves like the revert keyword.

should read more like this:

However, if the revert-layer keyword is set on a property outside a layer, the value of the property will roll back to any value set by presentational hints (e.g. the width or height attributes in HTML), defaulting to the value established by the user agent's stylesheet (or by user styles, if any exist). So in this scenario, the revert-layer keyword behaves very similarly to the revert keyword, with the exception that revert considers presentational hints to be part of the author origin, so it reverts them too.

Do you have any supporting links, references, or citations?

• [css-cascade] Cascade priority of presentation hints vs. tree scopes w3c/csswg-drafts#6659
  • Resulting spec diff: w3c/csswg-drafts@d7f41c4
• [css-cascade] Does 'revert-layer' roll back to preshints? w3c/csswg-drafts#7087
  • Resulting spec diff: w3c/csswg-drafts@20d186b

Do you have anything more you want to share?

Thank you!

MDN metadata