I would rather clarify the incorrect labels in the existing components. We obviously cannot change setLeft() - perhaps we should add explanation to the corresponding javadoc explaining RTL behavior. I would like to avoid making the same mistake going forward.
-andy From: Michael Strauß <[email protected]> Date: Tuesday, October 14, 2025 at 10:02 To: Andy Goryachev <[email protected]> Cc: Michael Strauß <[email protected]>, [email protected] <[email protected]> Subject: [External] : Re: RFR: 8369836: Update HeaderBar API Yes, exactly. "Left" and "right" is used in several places in JavaFX (BorderPane, AnchorPane, Insets) to effectively mean "leading" and "trailing". HeaderBar is different, because it uses "left", "right", as well as "leading" and "trailing" with a different definition than the other controls (leading and trailing are RTL adjusted, while left and right are not). My proposal is to just accept that "left" and "right" are JavaFX terminology for RTL-adjusted leading and trailing areas. On Tue, Oct 14, 2025 at 6:52 PM Andy Goryachev <[email protected]> wrote: > > Can you clarify what you mean by "aligning with" BorderPane? > > Does it mean we are trying to propagate somewhat misleading terminology that > was used by the BorderPane (setLeft() in RTL mode results in the added node > on the right side, so it should really be named something like setLeading() > instead of setLeft()). > > Thanks, > -andy
