On Wed, 7 Aug 2024 20:51:59 GMT, Andy Goryachev <ango...@openjdk.org> wrote:
> Regarding `cssref.html`: > > 1. I think it might make sense to add a section after "Transitions" talking > about component transitions, maybe with examples. > 2. I think we should to mention interpolation behavior next to each property > name somehow. Either mark the properties that do support it, or only those > that do not support. It is already documented in javadoc, but cssref.html is > a normative document for CSS. > > what do you think? I'm not sure what to say here, and I question whether introducing the concept of component-wise transitions to users is useful at all. This is more of an implementation detail, as from the perspective of CSS (where transitions are specified), there is no such thing: the reason why you can target `-fx-border-color` with a transition is because the property type is `Paint`, which implements `Interpolatable`. The fact that `Interpolatable` types support transitions is already mentioned in `cssref.html`; elaborating on terminology that has no further use in CSS might be even more confusing for users. There shouldn't be any need to either document support or non-support with regards to transitions, because the current language is already clear that if the property is not `Interpolatable`, there will be no transition. ------------- PR Comment: https://git.openjdk.org/jfx/pull/1522#issuecomment-2274773280
