JLayeredPane中层0菜单鼠标悬停时被层1组件遮挡问题求解

问题原因 #

你遇到的问题核心是层级设置颠倒：
JLayeredPane的Z轴排序规则为：层级数值越大，组件越靠近用户（显示优先级越高）。你当前将mainPanel设置为层级1、menu设置为层级0，mainPanel本身层级就高于menu。哪怕你调整menu的宽度覆盖到mainPanel的区域，mainPanel上的组件也会因为层级更高优先绘制，所以出现了单选按钮浮在menu上方的问题。

另外还有两个影响逻辑的次要问题：

• 鼠标监听器绑定对象错误：你将监听器绑定在JLayeredPane上，事件源永远是层级面板本身，无法匹配Menu.moreDetails，会导致展开/收起逻辑无法触发
• 尺寸调整后缺少重绘调用：仅调用revalidate不会触发组件重绘，容易出现绘制残留

解决方案 #

1. 修正层级顺序 #

调整JLayeredPane的组件添加逻辑，让menu的层级高于mainPanel，保证展开时可以覆盖下层面板内容：

// 原代码
// layer.add(mainPanel, 1);
// layer.add(menu, 0, 0);

// 修改后
layer.add(mainPanel, 0); // mainPanel放在底层
layer.add(menu, 1); // menu放在上层，展开时可覆盖mainPanel区域

2. 修正监听器绑定并增加重绘逻辑 #

将鼠标监听器绑定到触发点击的Menu.moreDetails组件上，同时在调整尺寸后增加重绘调用，避免绘制残留：

// 原代码 layer.addMouseListener(new MouseAdapter() {
// 修改为
Menu.moreDetails.addMouseListener(new MouseAdapter() {
    boolean open = false;
    @Override
    public void mousePressed(MouseEvent me) {
        if (open) {
            menu.setMaximumSize(new Dimension(24, DimMax.height));
            menu.setMinimumSize(new Dimension(24, DimMax.height));
            menu.setPreferredSize(new Dimension(24, DimMax.height));
            menu.setBounds(0, 0, 24, DimMax.height);
            menu.revalidate();
            menu.repaint();
            layer.repaint();
            open = false;
        } else {
            menu.setMaximumSize(new Dimension(120, DimMax.height));
            menu.setMinimumSize(new Dimension(120, DimMax.height));
            menu.setPreferredSize(new Dimension(120, DimMax.height));
            menu.setBounds(0, 0, 120, DimMax.height);
            menu.revalidate();
            menu.repaint();
            layer.repaint();
            open = true;
        }
    }
});

3. 可选优化 #

如果不需要mainPanel的透明效果，可将mainPanel.setOpaque(false)改为mainPanel.setOpaque(true)，减少不必要的透明绘制开销。

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