如何在Java Swing的非可聚焦JPopupMenu中启用键盘导航？

核心实现思路 #

• 保持JPopupMenu.setFocusable(false)的设置，避免菜单自身获取焦点
• 利用窗口级键盘事件捕获，确保窗口激活时能响应上下键操作
• 菜单显示时主动将焦点赋予第一个菜单项，触发键盘交互的基础条件
• 回车选择功能无需额外开发，JMenuItem默认支持回车触发绑定的动作

修改后的完整代码 #

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class PopupMenuExample {

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("PopupMenu Example");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(400, 400);

            JPopupMenu popupMenu = new JPopupMenu();
            JMenuItem menuItem1 = new JMenuItem("Option 1");
            JMenuItem menuItem2 = new JMenuItem("Option 2");
            JMenuItem menuItem3 = new JMenuItem("Option 3");

            popupMenu.add(menuItem1);
            popupMenu.add(menuItem2);
            popupMenu.add(menuItem3);

            // 保持菜单非可聚焦
            popupMenu.setFocusable(false);

            // 菜单项动作监听
            menuItem1.addActionListener(e -> System.out.println("Option 1 selected"));
            menuItem2.addActionListener(e -> System.out.println("Option 2 selected"));
            menuItem3.addActionListener(e -> System.out.println("Option 3 selected"));

            // 右键触发菜单显示
            frame.addMouseListener(new MouseAdapter() {
                @Override
                public void mousePressed(MouseEvent e) {
                    if (e.isPopupTrigger()) {
                        showPopupWithFocus(popupMenu, frame, e.getX(), e.getY());
                    }
                }

                @Override
                public void mouseReleased(MouseEvent e) {
                    if (e.isPopupTrigger()) {
                        showPopupWithFocus(popupMenu, frame, e.getX(), e.getY());
                    }
                }
            });

            // 注册上下键的全局窗口级键盘动作
            KeyStroke downKey = KeyStroke.getKeyStroke(KeyEvent.VK_DOWN, 0);
            KeyStroke upKey = KeyStroke.getKeyStroke(KeyEvent.VK_UP, 0);

            frame.getRootPane().registerKeyboardAction(
                e -> navigateMenu(popupMenu, 1),
                downKey,
                JComponent.WHEN_IN_FOCUSED_WINDOW
            );

            frame.getRootPane().registerKeyboardAction(
                e -> navigateMenu(popupMenu, -1),
                upKey,
                JComponent.WHEN_IN_FOCUSED_WINDOW
            );

            frame.setFocusable(true);
            frame.setVisible(true);
        });
    }

    // 显示菜单并自动聚焦第一个菜单项
    private static void showPopupWithFocus(JPopupMenu popupMenu, Component invoker, int x, int y) {
        popupMenu.show(invoker, x, y);
        // 延迟请求焦点，确保菜单完全渲染
        SwingUtilities.invokeLater(() -> {
            if (popupMenu.getComponentCount() > 0) {
                Component firstItem = popupMenu.getComponent(0);
                if (firstItem instanceof JMenuItem) {
                    ((JMenuItem) firstItem).requestFocusInWindow();
                }
            }
        });
    }

    // 菜单导航逻辑
    private static void navigateMenu(JPopupMenu popupMenu, int direction) {
        Component[] components = popupMenu.getComponents();
        if (components.length == 0) return;

        // 查找当前聚焦的菜单项
        JMenuItem focusedItem = null;
        for (Component comp : components) {
            if (comp instanceof JMenuItem && comp.hasFocus()) {
                focusedItem = (JMenuItem) comp;
                break;
            }
        }

        // 无焦点时默认选中第一个，计算下一个索引（支持循环导航）
        int currentIndex = focusedItem == null ? 0 : findComponentIndex(components, focusedItem);
        int nextIndex = (currentIndex + direction + components.length) % components.length;

        JMenuItem nextItem = (JMenuItem) components[nextIndex];
        nextItem.requestFocusInWindow();
        // 高亮选中项，增强视觉反馈
        nextItem.setArmed(true);
    }

    // 辅助方法：查找组件在数组中的索引
    private static int findComponentIndex(Component[] components, Component target) {
        for (int i = 0; i < components.length; i++) {
            if (components[i] == target) {
                return i;
            }
        }
        return -1;
    }
}

关键修改说明 #

1. 键盘事件注册范围调整
   原代码给每个菜单项用WHEN_FOCUSED注册事件，只有当前菜单项聚焦时才响应。改为给窗口RootPane用WHEN_IN_FOCUSED_WINDOW注册，只要窗口处于激活状态，就能捕获上下键，无需依赖单个菜单项的焦点状态。

2. 初始焦点自动设置
   封装showPopupWithFocus方法，在菜单显示后延迟请求第一个菜单项的焦点，解决菜单刚显示时无焦点导致键盘无响应的问题。

3. 导航逻辑优化

   • 处理无焦点时的默认选中逻辑，避免空指针；
   • 实现循环导航（最后一项按向下键回到第一项，第一项按向上键到最后一项）；
   • 添加setArmed(true)给选中项添加视觉高亮，提升交互体验。

4. 回车功能
   JMenuItem默认支持回车键触发绑定的ActionListener，只要菜单项处于聚焦状态，按回车就会执行对应动作，无需额外开发。

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