From 693fb3360550f8b15ea6aa147d40bcd13d06d8e7 Mon Sep 17 00:00:00 2001
From: Keith Cirkel
Date: Fri, 18 Jul 2025 15:59:24 +0100
Subject: [PATCH] [css-transitions-1]: add explanation & example for transition
shorthand parsing order
---
css-transitions-1/Overview.bs | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/css-transitions-1/Overview.bs b/css-transitions-1/Overview.bs
index b1235da6fba..2f4085cb800 100644
--- a/css-transitions-1/Overview.bs
+++ b/css-transitions-1/Overview.bs
@@ -403,6 +403,24 @@ Value Definitions {#values}
transition-delay.
+
+ Order is also important within each transition definition for distinguishing
+ <> values from other keywords. When parsing, keywords that are
+ valid for properties other than ''transition-property'' whose values were not found earlier
+ in the shorthand must be accepted for those properties rather than for
+ ''transition-property''. Furthermore, when serializing, default values of other properties
+ must be output in at least the cases necessary to distinguish a ''transition-property''
+ that could be a value of another property, and may be output in additional cases.
+
+
+
+ For example, a parsed value from ''transition: ease-in ease-out'' (where
+ ''transition-timing-function'' is ''transition-timing-function/ease-in'' and
+ ''transition-property'' is 'ease-out') must not be serialized as
+ ''transition: ease-out ease-in'' (where the ''transition-timing-function'' would be
+ ''transition-timing/ease-out'' and the ''transition-property'' would be ''ease-in'').
+
+
If there is more than one <> in the shorthand,
and any of the transitions has