On Sat, 8 Aug 2026 19:49:59 GMT, Marius Hanl <[email protected]> wrote:

>> This PR shows how virtual layouts could be implemented, as discussed on the 
>> mailinglist: 
>> https://mail.openjdk.org/archives/list/[email protected]/thread/PLNSQ3ZI63AVKEFKNT5GT6WHAD2GYMPC/
>> 
>> It would work by making new non-Node containers called Layouts which can 
>> contain a mix of either Nodes or other Layouts. Allowing Layouts to nest 
>> makes it possible to create a substructure similar to how nesting 
>> StackPane/HBox/VBox etc works today. An example is a simple control that has 
>> a graphic with a title and subtitle stacked vertically next to it:
>> 
>> 
>> +-------------+-----------------------------------------+
>> |             |                                         |
>> |             |                 Title                   |
>> |             |                                         |
>> |   Graphic   +-----------------------------------------+
>> |             |                                         |
>> |             |                Subtitle                 |
>> |             |                                         |
>> +-------------+-----------------------------------------+
>> 
>> For a control to model this, it would need a VBox containing the Title and 
>> Subtitle, and an HBox containing the Graphic and the VBox.  The two 
>> containers are heavy-weight Nodes and this incurs sufficiently large memory 
>> and performance penalties that most standard JavaFX controls will opt to 
>> instead roll their own layout code to avoid paying the cost for these.
>> 
>> With virtual layouts, the control could make use of non-Node containers. The 
>> control would add its three children (Graphic, Title and Subtitle) as direct 
>> children for display in the scene graph, but would offload their positioning 
>> to a virtual layout.  This roughly looks like this:
>> 
>> 
>>   public class TitledGraphic extends Region {
>>       private final HBoxLayout root;
>> 
>>       public TitledGraphic(Node graphic, String titleText, String 
>> subtitleText) {
>>           // Flat scene graph:
>>           getChildren().addAll(graphic, title, subtitle);
>> 
>>           // Create virtual layout:
>>           root = HBoxLayout.of(graphic, VBoxLayout.of(title, subtitle));
>>       }
>> 
>>       @Override
>>       protected void layoutChildren() {
>>           root.resizeRelocate(0, 0, getWidth(), getHeight());
>>       }
>> 
>>       @Override protected double computeMinWidth(double height)   { return 
>> root.minWidth(height); }
>>       @Override protected double computeMinHeight(double width)   { return 
>> root.minHeight(width); }...
>
> modules/javafx.graphics/src/main/java/com/sun/javafx/scene/layout/Snapper.java
>  line 172:
> 
>> 170:     double snapPositionY(double value);
>> 171:     double snapSpaceX(double value);
>> 172:     double snapSpaceY(double value);
> 
> could we perhaps have just `snapPositionX/Y`? Since `snapSpaceX/Y` is always 
> doing the same, I don't see any point to have both (and I already disliked 
> that in the current `Region` implementation)

It's possible, but they do have distinct purposes:

- Position for snapping coordinates (x/y)
  - Rounded to align controls to the closest possible display position
- Space for snapping "empty" areas (borders, spacing, margins)
  - Rounded because they don't display important content
- Size for snapping "content" areas (text, graphics)
  - Important, we don't want a text character or icon to be truncated by one 
pixel

So the type of snap function you use also tells you something about what you're 
snapping (and if you're passing a width of a piece of text to position or 
space, then that's a clear bug).

-------------

PR Review Comment: https://git.openjdk.org/jfx/pull/2241#discussion_r3741792140

Reply via email to