如何在StackPane动态缩放环境下保持JavaFX Dialog标题栏宽度一致？

背景信息 #

应用中大量使用JavaFX内置的Dialog组件，同时通过自定义工具类LetterBoxer.java将所有对话框及UI场景放入StackPane中，实现基于场景/窗口大小变化的动态居中与缩放。该工具会将UI组件放入StackPane并居中，根据场景/窗口的调整动态缩放组件。

问题 #

当显示标题长度不同的对话框时，每个Dialog的标题栏会自动调整宽度，导致不同对话框间出现视觉不一致的问题。

最小可复现示例（简化版） #

DynamicDialogFixedWidthExample.java #

package dynamicDialogFixedWidthExample;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.layout.AnchorPane;
import javafx.scene.layout.BorderPane;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class DynamicDialogFixedWidthExample extends Application {

    @Override
    public void start(Stage primaryStage) {
        Label headerLabel = new Label("An Extremely Long Header Title for Testing");
        headerLabel.setStyle("-fx-font-size: 16px; -fx-background-color: lightblue; -fx-padding: 10;");
        headerLabel.setWrapText(true);

        BorderPane borderPane = getBorderPane(headerLabel);

        AnchorPane rootAnchorPane = new AnchorPane(borderPane);
        AnchorPane.setTopAnchor(borderPane, 0.0);
        AnchorPane.setBottomAnchor(borderPane, 0.0);
        AnchorPane.setLeftAnchor(borderPane, 0.0);
        AnchorPane.setRightAnchor(borderPane, 0.0);

        LetterBoxer letterBoxer = new LetterBoxer();
        Scene scene = letterBoxer.box(rootAnchorPane);
        primaryStage.setScene(scene);

        scene.setOnMouseClicked(event -> {
            if (headerLabel.getText().equals("An Extremely Long Header Title for Testing")) {
                headerLabel.setText("Short");
            } else if (headerLabel.getText().equals("Short")) {
                headerLabel.setText("This is a Title");
            } else {
                headerLabel.setText("An Extremely Long Header Title for Testing");
            }
        });

        primaryStage.setTitle("Dynamic Width Dialog Example");
        primaryStage.setWidth(250);
        primaryStage.setHeight(250);
        primaryStage.show();
    }

    private static BorderPane getBorderPane(Label headerLabel) {
        Label centerContent = new Label("Centered Content Goes Here");
        centerContent.setStyle("-fx-font-size: 14px; -fx-background-color: lightgray; -fx-padding: 20;");

        Label footerLabel = new Label("Footer");
        footerLabel.setStyle("-fx-font-size: 14px; -fx-background-color: lightgreen; -fx-padding: 10;");

        BorderPane borderPane = new BorderPane();
        borderPane.setTop(headerLabel);
        borderPane.setCenter(centerContent);
        borderPane.setBottom(footerLabel);
        return borderPane;
    }

    public static void main(String[] args) {
        launch(args);
    }
}

LetterBoxer.java #

package dynamicDialogFixedWidthExample;

import javafx.beans.value.ChangeListener;
import javafx.beans.value.ObservableValue;
import javafx.geometry.Bounds;
import javafx.scene.Group;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.layout.StackPane;
import javafx.scene.transform.Scale;

public class LetterBoxer {

    public Scene box(final Parent content) {
        return box(content, 1);
    }

    public Scene box(final Parent content, final double minScale) {
        // 用Group包裹内容，让StackPane居中缩放后的节点而非原始节点
        Group group = new Group(content);
        Scene scene = new Scene(group);
        // 触发布局计算
        group.applyCss();
        group.layout();

        // 获取初始布局的宽高比
        final Bounds layoutBounds = group.getLayoutBounds();
        final double initWidth = layoutBounds.getWidth();
        final double initHeight = layoutBounds.getHeight();
        final double ratio = initWidth / initHeight;

        StackPane stackPane = new StackPane(group);
        // 将根节点设置为StackPane以保持居中
        scene.setRoot(stackPane);
        
        BoxParams boxParams = new BoxParams(
                scene, minScale, ratio, initHeight, initWidth, content
        );

        // 添加监听器，在场景大小变化时调整内容缩放比例
        BoxSizeAdjuster boxSizeAdjuster = new BoxSizeAdjuster(boxParams);
        scene.widthProperty().addListener(boxSizeAdjuster);
        scene.heightProperty().addListener(boxSizeAdjuster);

        return scene;
    }

    private record BoxParams(
            Scene scene,
            double minScale,
            double ratio,
            double initHeight, double initWidth,
            Parent content
    ) {
    }

    private static class BoxSizeAdjuster
            implements ChangeListener<Number> {

        private final BoxParams boxParams;
        private final Scale scale = new Scale();

        public BoxSizeAdjuster(BoxParams boxParams) {
            this.boxParams = boxParams;

            scale.setPivotX(0);
            scale.setPivotY(0);

            boxParams.content.getTransforms().setAll(scale);
        }

        @Override
        public void changed(
                ObservableValue<? extends Number> observableValue,
                Number oldValue,
                Number newValue
        ) {
            final double newWidth = boxParams.scene.getWidth();
            final double newHeight = boxParams.scene.getHeight();

            final double scaleFactor =
                    Math.max(
                            newWidth / newHeight > boxParams.ratio
                                    ? newHeight / boxParams.initHeight
                                    : newWidth / boxParams.initWidth,
                            boxParams.minScale
                    );

            scale.setX(scaleFactor);
            scale.setY(scaleFactor);
        }
    }
}

由于标题长度不同，标题栏宽度会出现明显波动。

已尝试方案（无效） #

• 在主舞台上设置固定宽度或最小宽度。

结合自定义StackPane缩放包装器后，这些方案无法提供一致的动态适配效果。

需求 #

如何在StackPane构建的动态缩放环境中，持续确保JavaFX Dialog标题栏宽度稳定一致？

解决方案 #

1. 强制标题栏占满父容器宽度 #

利用BorderPane的布局特性，让标题栏自动填充整个顶部区域的宽度，不受文本长度影响：

修改getBorderPane方法，给标题栏添加宽度约束：

private static BorderPane getBorderPane(Label headerLabel) {
    // 让标题栏占满BorderPane的顶部宽度
    headerLabel.setMaxWidth(Double.MAX_VALUE);
    headerLabel.setAlignment(Pos.CENTER_LEFT); // 可选，保持文本左对齐

    Label centerContent = new Label("Centered Content Goes Here");
    centerContent.setStyle("-fx-font-size: 14px; -fx-background-color: lightgray; -fx-padding: 20;");

    Label footerLabel = new Label("Footer");
    footerLabel.setStyle("-fx-font-size: 14px; -fx-background-color: lightgreen; -fx-padding: 10;");

    BorderPane borderPane = new BorderPane();
    borderPane.setTop(headerLabel);
    borderPane.setCenter(centerContent);
    borderPane.setBottom(footerLabel);
    return borderPane;
}

这样标题栏会始终填满BorderPane的顶部宽度，无论文本长短，宽度都保持一致。

2. 固定标题栏的最小宽度 #

直接给标题栏组件设置最小宽度，确保即使标题文本很短，标题栏也不会收缩到小于设定的宽度。可以基于最长标题的宽度来设置，或者指定固定值：

// 初始化headerLabel时添加最小宽度设置
Label headerLabel = new Label("An Extremely Long Header Title for Testing");
headerLabel.setStyle("-fx-font-size: 16px; -fx-background-color: lightblue; -fx-padding: 10;");
headerLabel.setWrapText(true);
// 自动使用组件的首选宽度（即最长文本的宽度）
headerLabel.setMinWidth(Region.USE_PREF_SIZE);
// 或者直接指定固定像素值
// headerLabel.setMinWidth(220);

3. 调整LetterBoxer的缩放逻辑 #

原LetterBoxer的缩放基于初始内容的宽高比，当标题文本变化后，初始比例不再适配新内容。可以修改缩放逻辑，基于场景的固定宽高比计算：

// 修改BoxSizeAdjuster中的scaleFactor计算逻辑
@Override
public void changed(
        ObservableValue<? extends Number> observableValue,
        Number oldValue,
        Number newValue
) {
    final double newWidth = boxParams.scene.getWidth();
    final double newHeight = boxParams.scene.getHeight();

    final double scaleFactor =
            Math.max(
                    // 假设设计的宽高比为1:1，可根据需求调整
                    newWidth / newHeight > 1.0
                            ? newHeight / boxParams.initHeight
                            : newWidth / boxParams.initWidth,
                    boxParams.minScale
            );

    scale.setX(scaleFactor);
    scale.setY(scaleFactor);
}

4. 统一Dialog窗口宽度 #

对于Dialog组件，直接设置固定的最小/最大宽度，确保所有Dialog的窗口尺寸一致：

Dialog<Void> dialog = new Dialog<>();
dialog.setMinWidth(300);
dialog.setMaxWidth(300);
// 再将Dialog内容用LetterBoxer包装

内容的提问来源于stack exchange，提问作者Billie