非聚焦JavaFX Stage鼠标事件：顶层导航栏与下层舞台交互实现

要实现Stage1作为始终顶层的导航栏，同时在其下方的Stage2能在Stage1获得焦点时直接交互，无需JNI或额外库，可通过JavaFX的事件穿透特性实现：

核心思路 #

让顶层导航栏（Stage1）仅对需要交互的控件响应鼠标事件，空白区域允许鼠标事件穿透到下层窗口（Stage2），避免切换焦点的操作。

具体实现步骤 #

1. 配置顶层导航栏Stage1

   • 设置为无装饰窗口并始终置顶：

     Stage stage1 = new Stage();
     stage1.initStyle(StageStyle.UNDECORATED);
     stage1.setAlwaysOnTop(true);
     // 设置导航栏尺寸，比如占满屏幕宽度，高度50
     stage1.setWidth(Screen.getPrimary().getVisualBounds().getWidth());
     stage1.setHeight(50);
     

   • 给导航栏的根容器设置setPickOnBounds(false)，让空白区域不拦截鼠标事件：

     BorderPane navRoot = new BorderPane();
     navRoot.setStyle("-fx-background-color: #333;");
     navRoot.setPickOnBounds(false); // 根节点放弃非子控件区域的鼠标事件拦截
     

   • 给导航栏内需要交互的控件（如按钮、菜单）单独设置setPickOnBounds(true)，确保这些控件能正常响应事件：

     Button navBtn = new Button("功能按钮");
     navBtn.setPickOnBounds(true);
     navBtn.setOnAction(e -> {
         // 导航栏按钮的业务逻辑
         System.out.println("导航按钮触发");
     });
     navRoot.setLeft(navBtn);
     

   • 加载场景并显示：

     stage1.setScene(new Scene(navRoot));
     stage1.show();
     

2. 配置下层窗口Stage2
   正常创建并显示即可，无需特殊设置：

   Stage stage2 = new Stage();
   stage2.setTitle("主内容窗口");
   Label contentLabel = new Label("点击我测试交互");
   contentLabel.setFont(Font.font(16));
   stage2.setScene(new Scene(contentLabel, 600, 400));
   stage2.show();
   

原理说明 #

setPickOnBounds(false)会让节点仅在包含可交互子节点的区域接收鼠标事件，空白区域的鼠标事件会直接穿透到下层窗口。这样既保证了导航栏始终置顶，又无需切换焦点就能直接操作下层窗口，解决了多次点击切换焦点的问题。

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