JavaFX如何让Stage显示时永不获取焦点且始终置顶

这个问题我之前做桌面通知组件的时候也踩过坑！要实现这种「只悬浮显示、绝不抢走原应用焦点」的右下角通知弹窗，得结合JavaFX里几个关键的Stage设置，我给你一步步拆解：

核心设置步骤 #

• 使用无装饰窗口样式
  先把Stage的样式设为StageStyle.UNDECORATED，因为默认的窗口样式会自带系统级的焦点逻辑，去掉装饰后能完全掌控窗口的焦点行为：

  notificationStage.initStyle(StageStyle.UNDECORATED);
  

• 禁用焦点遍历能力
  分别给Stage和Scene设置setFocusTraversable(false)，明确告诉它们不要参与系统的焦点遍历流程，从根源上避免主动抢焦点：

  notificationStage.setFocusTraversable(false);
  scene.setFocusTraversable(false);
  

• 显示后强制释放焦点
  就算做了上面的设置，有些系统环境下Stage显示时还是会偷偷获取焦点，这时候在show()之后手动调用setFocused(false)，强制让通知窗口失去焦点：

  notificationStage.show();
  notificationStage.setFocused(false);
  

• 可选：绑定到主窗口（增强稳定性）
  如果你的通知是从主应用弹出的，可以把主Stage设为通知窗口的所有者，这样通知会依附于主窗口，更不容易出现焦点异常：

  notificationStage.initOwner(primaryStage);
  

完整代码示例 #

下面是一个可以直接运行的Demo，模拟右下角的无焦点通知：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.VBox;
import javafx.scene.text.Text;
import javafx.stage.Stage;
import javafx.stage.StageStyle;

public class NonFocusingNotificationDemo extends Application {
    @Override
    public void start(Stage primaryStage) {
        // 构建通知内容
        VBox notificationBox = new VBox(new Text("您有一条新消息！"));
        notificationBox.setStyle("-fx-background: #ffffff; -fx-padding: 16px; -fx-border-color: #e0e0e0; -fx-border-width: 1px;");

        // 创建场景并禁用焦点遍历
        Scene scene = new Scene(notificationBox, 320, 90);
        scene.setFocusTraversable(false);

        // 配置通知窗口
        Stage notificationStage = new Stage();
        notificationStage.initOwner(primaryStage); // 绑定主窗口
        notificationStage.initStyle(StageStyle.UNDECORATED); // 无装饰
        notificationStage.setAlwaysOnTop(true); // 始终置顶
        notificationStage.setFocusTraversable(false); // 禁用焦点遍历
        notificationStage.setScene(scene);

        // 定位到屏幕右下角（留20px边距）
        var screenBounds = primaryStage.getScreen().getVisualBounds();
        notificationStage.setX(screenBounds.getWidth() - 340);
        notificationStage.setY(screenBounds.getHeight() - 110);

        // 显示并强制失去焦点
        notificationStage.show();
        notificationStage.setFocused(false);

        // 主窗口示例（模拟原应用）
        primaryStage.setTitle("原应用窗口");
        primaryStage.setScene(new Scene(new VBox(new Text("这是原应用内容")), 400, 300));
        primaryStage.show();
    }

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

额外注意事项 #

• 如果需要做圆角或半透明通知，可以把Stage样式换成StageStyle.TRANSPARENT，配合Scene的背景透明设置，核心的焦点逻辑完全一致。
• 不同操作系统的窗口管理逻辑略有差异，比如Windows 11的焦点机制更严格，上面的设置在所有主流桌面系统（Windows、macOS、Linux）都能稳定工作。

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