Javadocs and CSS

[Tom Schindl]

Well that would work for properties on controls but many of them are in the Skin classes and those could be different from platform to platform and theme to theme and so are an implementation detail.

Tom

Von meinem iPhone gesendet

> Am 16.05.2014 um 16:38 schrieb Scott Palmer <swpalmer at gmail.com>:
> 
> Should a better cross-reference or mention of CSS properties in the Javadocs?
> 
> Many properties can be set via calling methods or through CSS, but
> when browsing the Javadocs the related CSS properties are not
> mentioned (at least not in most cases).
> 
> The package docs for javafx.scene mention the CSS Reference Guide at
> the end of the description, and careful reading of that document
> mentions the convention used to go from JavaFX variable names to CSS
> property. (last paragraph of
> http://docs.oracle.com/javase/8/javafx/api/javafx/scene/doc-files/cssref.html#introscenegraph)
> 
> I think all that is needed is to mention in the JavaDocs if the
> property is configurable from CSS or not. Or at least mention the
> exceptions to the rule.  For example most properties of Labeled are
> configurable via CSS, but "lineSpacing" and "mnemonicParsing" are
> *not* mentioned among the CSS properties.
> (http://docs.oracle.com/javase/8/javafx/api/javafx/scene/doc-files/cssref.html#labeled)
> 
> 
> Scott