Swing弹窗向左调整大小时闪烁问题的技术问询

问题分析 #

当前实现的核心问题是UI更新顺序错位：

• 点击"More"时，Popup的位置和尺寸先更新，但内容组件的重绘未同步完成，导致短暂显示空白或旧内容
• 点击"Less"时，Popup位置更新后，组件尺寸和内容的更新未触发，显示过时UI
• 直接调用revalidate()/repaint()无效，因为这些操作的执行时机未与Popup的位置/尺寸调整对齐

解决方案 #

通过以下步骤修复闪烁问题，确保所有UI更新在事件调度线程（EDT）上按正确顺序执行：

1. 统一UI更新时机 #

用SwingUtilities.invokeLater()将Popup的尺寸调整、定位和重绘操作放到EDT事件队列末尾，确保组件可见性切换完成后再执行Popup更新。

2. 调整Popup更新逻辑 #

先完成内容面板的可见性切换和尺寸计算，再一次性更新Popup的位置和尺寸，避免分步操作导致的视觉断层。

3. 优化重定位方法 #

调整resizeAndRelocatePopup方法逻辑：先隐藏旧Popup，计算好新尺寸和位置后再创建并显示新Popup，避免中间状态的闪烁。

修复后的完整代码 #

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

public class RightAlignedPopupDemo {
    private Popup popup;
    private JPanel popupContent;
    private JPanel morePanel;
    private JButton toggleButton;
    private boolean isExpanded = false;

    public static void main(String[] args) {
        SwingUtilities.invokeLater(RightAlignedPopupDemo::new);
    }

    public RightAlignedPopupDemo() {
        JFrame frame = new JFrame("Right-Aligned Popup Demo");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(600, 400);
        frame.setLayout(new BorderLayout());

        toggleButton = new JButton("Show Popup");
        frame.add(toggleButton, BorderLayout.EAST);

        // 弹窗内容容器
        popupContent = new JPanel(new BorderLayout());
        popupContent.setBorder(BorderFactory.createLineBorder(Color.GRAY));

        // 基础内容区
        JPanel basicPanel = new JPanel();
        basicPanel.add(new JLabel("Basic Content"));
        basicPanel.add(new JButton("Action"));
        popupContent.add(basicPanel, BorderLayout.NORTH);

        // 展开内容区
        morePanel = new JPanel();
        morePanel.add(new JLabel("Expanded Content Line 1"));
        morePanel.add(new JLabel("Expanded Content Line 2"));
        morePanel.setVisible(false);
        popupContent.add(morePanel, BorderLayout.CENTER);

        // 展开/收起按钮
        JButton expandButton = new JButton("More");
        expandButton.addActionListener(e -> toggleExpandState());
        popupContent.add(expandButton, BorderLayout.SOUTH);

        // 主触发按钮逻辑
        toggleButton.addActionListener(e -> {
            if (popup == null || !popup.isVisible()) {
                showPopup();
            } else {
                popup.hide();
                popup = null;
            }
        });

        // 窗口 resize 时同步调整弹窗位置
        frame.addComponentListener(new ComponentAdapter() {
            @Override
            public void componentResized(ComponentEvent e) {
                if (popup != null && popup.isVisible()) {
                    resizeAndRelocatePopup();
                }
            }
        });

        frame.setLocationRelativeTo(null);
        frame.setVisible(true);
    }

    private void toggleExpandState() {
        isExpanded = !isExpanded;
        morePanel.setVisible(isExpanded);
        ((JButton) popupContent.getComponent(2)).setText(isExpanded ? "Less" : "More");

        // 确保组件状态切换完成后再更新弹窗
        SwingUtilities.invokeLater(() -> {
            if (popup != null && popup.isVisible()) {
                resizeAndRelocatePopup();
            }
        });
    }

    private void showPopup() {
        Point triggerLocation = toggleButton.getLocationOnScreen();
        Dimension popupSize = popupContent.getPreferredSize();
        
        // 计算初始位置：按钮下方，向左展开，确保在窗口边界内
        int popupX = triggerLocation.x - popupSize.width;
        int popupY = triggerLocation.y + toggleButton.getHeight();

        JFrame frame = (JFrame) SwingUtilities.getWindowAncestor(toggleButton);
        Rectangle screenBounds = frame.getGraphicsConfiguration().getBounds();
        // 边界修正
        popupX = Math.max(screenBounds.x, popupX);
        popupY = (popupY + popupSize.height > screenBounds.y + screenBounds.height) 
                ? triggerLocation.y - popupSize.height 
                : popupY;

        popup = PopupFactory.getSharedInstance().getPopup(toggleButton, popupContent, popupX, popupY);
        popup.show();
    }

    private void resizeAndRelocatePopup() {
        if (popup == null || !popup.isVisible()) return;

        // 先隐藏旧弹窗，避免更新过程中闪烁
        popup.hide();

        Point triggerLocation = toggleButton.getLocationOnScreen();
        Dimension newSize = popupContent.getPreferredSize();
        int newX = triggerLocation.x - newSize.width;
        int newY = triggerLocation.y + toggleButton.getHeight();

        JFrame frame = (JFrame) SwingUtilities.getWindowAncestor(toggleButton);
        Rectangle screenBounds = frame.getGraphicsConfiguration().getBounds();
        // 重新修正边界
        newX = Math.max(screenBounds.x, newX);
        newY = (newY + newSize.height > screenBounds.y + screenBounds.height) 
                ? triggerLocation.y - newSize.height 
                : newY;

        // 创建新弹窗并显示
        popup = PopupFactory.getSharedInstance().getPopup(toggleButton, popupContent, newX, newY);
        popup.show();

        // 强制内容容器重绘
        popupContent.revalidate();
        popupContent.repaint();
    }
}

关键优化点 #

• EDT队列延迟执行：用SwingUtilities.invokeLater()确保组件状态切换完成后再更新Popup，避免重绘时机过早
• 先隐藏再重建Popup：调整尺寸位置时先隐藏旧Popup，再创建新Popup显示，消除中间过渡状态的闪烁
• 统一尺寸计算：先获取内容面板最新首选尺寸，再计算Popup位置，确保尺寸与位置的一致性

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