跨操作系统实现可最小化的JavaFX非模态Dialog

问题背景 #

需要实现一款在所有操作系统中，窗口顶部显示最小化按钮的非模态Dialog，当前遇到的矛盾点：

• Windows系统：仅能通过不为Dialog设置所有者实现最小化按钮显示，但此设置在部分macOS设备上会引发Bug——当主Stage处于最大化状态时，无所有者的Dialog会全屏显示且四周出现黑边
• macOS系统：设置了所有者的Dialog无法显示最小化按钮；未设置所有者的Dialog虽能显示最小化按钮，但存在上述全屏黑边Bug（仅部分设备出现）

解决方案 #

核心思路是针对不同操作系统做差异化配置，同时对macOS的特殊Bug做适配，以下提供两种可行方案：

方案一：差异化配置Dialog属性 #

通过判断当前操作系统，分别设置Dialog的所有者及样式，同时针对macOS的全屏黑边Bug添加动态调整逻辑：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.ButtonType;
import javafx.scene.control.Dialog;
import javafx.scene.layout.StackPane;
import javafx.stage.Modality;
import javafx.stage.Stage;
import javafx.stage.StageStyle;

public class DialogTest extends Application {

    @Override
    public void start(Stage primaryStage) {
        Button button = new Button("Show Dialog");
        button.setOnAction(ae -> {
            Dialog<ButtonType> dialog = new Dialog<>();
            dialog.getDialogPane().getButtonTypes().add(ButtonType.OK);
            dialog.initModality(Modality.NONE);
            dialog.initStyle(StageStyle.DECORATED);

            String osName = System.getProperty("os.name").toLowerCase();
            if (osName.contains("win")) {
                // Windows系统：不设置所有者，确保最小化按钮正常显示
            } else if (osName.contains("mac")) {
                // macOS系统：设置所有者，同时监听主Stage状态避免黑边Bug
                dialog.initOwner(primaryStage);
                primaryStage.maximizedProperty().addListener((obs, oldVal, newVal) -> {
                    if (newVal) {
                        dialog.setWidth(400);
                        dialog.setHeight(200);
                        dialog.setResizable(false);
                    } else {
                        dialog.setResizable(true);
                    }
                });
                // 启用窗口工具条以显示最小化按钮
                dialog.getDialogPane().getScene().getWindow().setStyle("-fx-window-style: utility;");
            }

            dialog.showAndWait();
        });

        StackPane root = new StackPane(button);
        Scene scene = new Scene(root, 320, 240);
        primaryStage.setTitle("Dialog Test");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

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

方案二：用Stage模拟Dialog（更灵活） #

由于JavaFX的Dialog受平台限制较多，可直接使用Stage来模拟非模态Dialog，完全自定义窗口行为：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.ButtonType;
import javafx.scene.control.DialogPane;
import javafx.scene.layout.StackPane;
import javafx.stage.Modality;
import javafx.stage.Stage;

public class StageAsDialogTest extends Application {

    @Override
    public void start(Stage primaryStage) {
        Button button = new Button("Show Dialog");
        button.setOnAction(ae -> {
            // 创建模拟Dialog的Stage
            Stage dialogStage = new Stage();
            dialogStage.initModality(Modality.NONE);
            dialogStage.setTitle("Custom Dialog");

            // 使用DialogPane保持原生Dialog样式
            DialogPane dialogPane = new DialogPane();
            dialogPane.getButtonTypes().add(ButtonType.OK);
            dialogPane.lookupButton(ButtonType.OK).setOnAction(e -> dialogStage.close());

            Scene dialogScene = new Scene(dialogPane, 400, 200);
            dialogStage.setScene(dialogScene);

            String osName = System.getProperty("os.name").toLowerCase();
            if (osName.contains("win")) {
                dialogStage.initOwner(null); // Windows不设置所有者
            } else if (osName.contains("mac")) {
                dialogStage.initOwner(primaryStage); // macOS设置所有者
                dialogStage.setMinimizable(true); // 强制开启最小化按钮
            }

            dialogStage.show();
        });

        StackPane root = new StackPane(button);
        Scene scene = new Scene(root, 320, 240);
        primaryStage.setTitle("Stage as Dialog Test");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

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

说明 #

• 方案一保留了原生Dialog的样式，通过系统判断和状态监听适配平台差异
• 方案二使用Stage完全自定义窗口行为，灵活性更高，可避免Dialog的平台限制问题
• Linux系统可参考Windows或macOS的配置，根据实际测试结果调整（若出现问题，可尝试不设置所有者并启用StageStyle.DECORATED）

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