<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Aptos;
panose-1:2 11 0 4 2 2 2 2 2 4;}
@font-face
{font-family:"Iosevka Fixed SS16";
panose-1:2 0 5 9 3 0 0 0 0 4;}
@font-face
{font-family:"Times New Roman \(Body CS\)";
panose-1:2 11 6 4 2 2 2 2 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
font-size:10.0pt;
font-family:"Aptos",sans-serif;}
span.EmailStyle19
{mso-style-type:personal-reply;
font-family:"Iosevka Fixed SS16";
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;
mso-ligatures:none;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style>
</head>
<body lang="EN-US" link="#467886" vlink="#96607D" style="word-wrap:break-word">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Iosevka Fixed SS16"">Thank you for your feedback!<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Iosevka Fixed SS16""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Iosevka Fixed SS16"">I agree: referring to places in cssref.html is a good idea. And perhaps even referring from cssref.html to javadoc might be also a good idea, though cssref.html does suggest
the class which owns the corresponding properties, or at least the class in question can be found in most cases.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Iosevka Fixed SS16""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Iosevka Fixed SS16"">-andy<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Iosevka Fixed SS16""><o:p> </o:p></span></p>
<div id="mail-editor-reference-message-container">
<div>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal" style="margin-bottom:12.0pt"><b><span style="font-size:12.0pt;color:black">From:
</span></b><span style="font-size:12.0pt;color:black">openjfx-dev <openjfx-dev-retn@openjdk.org> on behalf of Markus Mack <markus.mack@gmail.com><br>
<b>Date: </b>Monday, July 1, 2024 at 04:48<br>
<b>To: </b>openjfx-dev@openjdk.org <openjfx-dev@openjdk.org><br>
<b>Subject: </b>Re: Should we document Styleable properties?<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><span style="font-size:11.0pt">I'd say this is a good idea. Both variants are good, we might want to
<br>
mention CSS in the first one, though.<br>
<br>
Not sure how others do it, but I regularly struggle to find out which <br>
code properties correspond to which CSS styles. This is particularly the <br>
case for names like "background", "border", or "stroke", where there is <br>
no clean 1:1 correspondence, or similar names are used in multiple contexts.<br>
<br>
Some way of linking to the current CSS reference might also be helpful <br>
to find out about allowed arguments. If I google something like "javafx <br>
css" I typically only get links to outdated versions of the CSS <br>
reference. Also, linking back from the CSS reference to the code <br>
properties' javadoc pages is something I've been missing - maybe this <br>
could be added without much additional effort if javadocs are updated <br>
according to this proposal?<br>
<br>
Am 28.06.2024 um 23:04 schrieb Andy Goryachev:<br>
><br>
> Dear fellow developers:<br>
><br>
> Should we document which properties are styleable with CSS in <br>
> javadoc? Would that be useful?<br>
><br>
> Example:<br>
><br>
> /**<br>
><br>
> * Determines the caret blink period. This property cannot be set <br>
> to {@code null}.<br>
><br>
> * <p><br>
><br>
> * This is a {@link StyleableProperty} with the name {@code <br>
> -fx-caret-blink-period}.<br>
><br>
> * <p><br>
><br>
> alternative:<br>
><br>
> * This property can be styled with CSS using {@code <br>
> -fx-caret-blink-period} name.<br>
><br>
> * @implNote The property object implements {@link <br>
> StyleableProperty} interface.<br>
><br>
> Other ideas are also welcome.<br>
><br>
> -andy<br>
><o:p></o:p></span></p>
</div>
</div>
</div>
</div>
</body>
</html>