如何创建可展开且可滚动的Swing列表？现有问题求解

问题1：展开内容时视图跳回顶部的修复 #

展开时滚动视图跳顶，是因为容器布局更新后，滚动面板的视口自动重置到顶部。解决思路是更新布局前记录当前视口位置，更新后恢复：

在触发展开/折叠的按钮事件中，先获取滚动面板的视口坐标，再切换内容面板的可见性，最后把视口移回原位置：

// 在EntryListPanelTest的按钮点击监听器中
JScrollPane scrollPane = (JScrollPane) SwingUtilities.getAncestorOfClass(JScrollPane.class, this);
Point viewPos = scrollPane.getViewport().getViewPosition();

// 切换内容面板可见性
contentPanel.setVisible(!contentPanel.isVisible());
// 更新容器布局
revalidate();
repaint();

// 恢复视口位置
scrollPane.getViewport().setViewPosition(viewPos);

如果使用BoxLayout，也可以通过手动调整组件高度避免自动滚动：

// 折叠时设置内容面板高度为0，展开时恢复原高度
if (!contentPanel.isVisible()) {
    contentPanel.setMaximumSize(new Dimension(Integer.MAX_VALUE, 0));
    contentPanel.setMinimumSize(new Dimension(0, 0));
} else {
    contentPanel.setMaximumSize(new Dimension(Integer.MAX_VALUE, Short.MAX_VALUE));
    contentPanel.setMinimumSize(contentPanel.getPreferredSize());
}

问题2：窗口调整时未展开项的空白间距修复 #

空白间距是因为布局管理器给未展开的项分配了额外垂直空间。推荐用GridBagLayout替代BoxLayout作为容器布局，让每个可展开项只占用自身所需的固定高度：

1. 容器ListPanelTest的布局设置为GridBagLayout：

public ListPanelTest() {
    setLayout(new GridBagLayout());
    GridBagConstraints gbc = new GridBagConstraints();
    gbc.gridx = 0;
    gbc.gridy = 0;
    gbc.fill = GridBagConstraints.HORIZONTAL;
    gbc.weightx = 1.0;
    gbc.weighty = 0.0; // 未展开时不分配额外垂直空间
}

2. 添加每个EntryListPanelTest时，复用同一个GridBagConstraints：

public void addEntry(EntryListPanelTest entry) {
    GridBagConstraints gbc = ((GridBagLayout) getLayout()).getConstraints(this);
    gbc.gridy = getComponentCount();
    add(entry, gbc);
}

这样窗口调整大小时，未展开的按钮只会保持自身固定高度，不会出现多余空白。

无额外依赖的简化实现方案 #

不需要复杂的嵌套面板，直接用「按钮+内容面板」的组合，结合SpringLayout实现更轻量的可展开容器：

核心容器类（简化版） #

public class CollapsiblePanelContainer extends JPanel {
    private SpringLayout layout;
    private int nextY = 0;

    public CollapsiblePanelContainer() {
        layout = new SpringLayout();
        setLayout(layout);
    }

    public void addCollapsibleItem(String title, JPanel content) {
        // 固定尺寸的展开/折叠按钮
        JButton toggleBtn = new JButton(title);
        toggleBtn.setPreferredSize(new Dimension(400, 30));
        toggleBtn.addActionListener(e -> {
            boolean isVisible = content.isVisible();
            content.setVisible(!isVisible);
            // 调整后续组件位置
            updateComponentPositions(toggleBtn, content, isVisible);
            // 修复滚动跳顶
            JScrollPane scrollPane = (JScrollPane) SwingUtilities.getAncestorOfClass(JScrollPane.class, this);
            if (scrollPane != null) {
                Point viewPos = scrollPane.getViewport().getViewPosition();
                revalidate();
                repaint();
                scrollPane.getViewport().setViewPosition(viewPos);
            }
        });

        // 初始化内容面板为隐藏
        content.setVisible(false);
        content.setMaximumSize(new Dimension(Integer.MAX_VALUE, content.getPreferredSize().height));

        // 添加组件到容器并设置初始约束
        add(toggleBtn);
        add(content);

        layout.putConstraint(SpringLayout.WEST, toggleBtn, 10, SpringLayout.WEST, this);
        layout.putConstraint(SpringLayout.EAST, toggleBtn, -10, SpringLayout.EAST, this);
        layout.putConstraint(SpringLayout.NORTH, toggleBtn, nextY, SpringLayout.NORTH, this);

        layout.putConstraint(SpringLayout.WEST, content, 10, SpringLayout.WEST, this);
        layout.putConstraint(SpringLayout.EAST, content, -10, SpringLayout.EAST, this);
        layout.putConstraint(SpringLayout.NORTH, content, nextY + toggleBtn.getPreferredSize().height, SpringLayout.NORTH, this);

        nextY += toggleBtn.getPreferredSize().height + (content.isVisible() ? content.getPreferredSize().height : 0);
        layout.putConstraint(SpringLayout.SOUTH, this, nextY, SpringLayout.NORTH, this);
    }

    private void updateComponentPositions(JButton btn, JPanel content, boolean wasVisible) {
        int contentHeight = content.getPreferredSize().height;
        int delta = wasVisible ? -contentHeight : contentHeight;

        // 调整当前内容面板的约束
        if (!wasVisible) {
            layout.putConstraint(SpringLayout.SOUTH, content, layout.getConstraint(SpringLayout.NORTH, content).getValue() + contentHeight, SpringLayout.NORTH, this);
        } else {
            layout.putConstraint(SpringLayout.SOUTH, content, layout.getConstraint(SpringLayout.NORTH, content).getValue(), SpringLayout.NORTH, this);
        }

        // 调整后续所有组件的Y坐标
        Component[] components = getComponents();
        int targetIndex = Arrays.asList(components).indexOf(content) + 1;
        for (int i = targetIndex; i < components.length; i++) {
            Component comp = components[i];
            Spring northConstraint = layout.getConstraint(SpringLayout.NORTH, comp);
            layout.putConstraint(SpringLayout.NORTH, comp, northConstraint.getValue() + delta, SpringLayout.NORTH, this);
        }

        // 调整容器底部约束
        Spring southConstraint = layout.getConstraint(SpringLayout.SOUTH, this);
        layout.putConstraint(SpringLayout.SOUTH, this, southConstraint.getValue() + delta, SpringLayout.NORTH, this);
    }
}

使用方式 #

public class TestGui {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("可展开面板测试");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(500, 400);

            CollapsiblePanelContainer container = new CollapsiblePanelContainer();

            // 添加测试项
            JPanel content1 = new JPanel();
            content1.add(new JLabel("这是第一个展开内容"));
            container.addCollapsibleItem("项目1", content1);

            JPanel content2 = new JPanel();
            content2.add(new JTextField(20));
            container.addCollapsibleItem("项目2", content2);

            JScrollPane scrollPane = new JScrollPane(container);
            scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
            frame.add(scrollPane);
            frame.setVisible(true);
        });
    }
}

这个实现基于Swing原生API，无需额外依赖，同时解决了滚动跳顶和空白间距问题，按钮尺寸固定，展开时下方组件自动移位。

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