Java Swing JSplitPane设置最大尺寸后面板仍可超限拉伸问题

问题原因 #

你遇到的问题不是代码语法错误，是Swing组件的默认行为导致的：

• JPanel默认使用FlowLayout，该布局不会主动向父容器传递严格的尺寸约束，单纯调用setMaximumSize()不会被JSplitPane的分割条拖动逻辑识别
• JSplitPane本身没有内置拖动分割条时自动校验子组件最大/最小尺寸的逻辑，默认会允许分割条拖动到整个分割面板的可用宽度边界
• 你的代码里把contactsSplitPane添加到JFrame的操作写在了setVisible(true)之后，这是Swing开发的常见错误，所有组件的添加、布局配置必须在窗口设为可见之前完成，否则会出现各种渲染、布局异常。

修复方案 #

要实现listPanel最大宽度300px的限制，两步即可：

• 调整代码顺序，先给frame添加组件，最后再设置窗口可见
• 给JSplitPane添加分割条位置变化的监听器，当分割条位置超过300px时强制回弹到最大允许位置，也可以重写listPanel的getMaximumSize()方法确保尺寸约束返回值固定不被布局修改。

可运行修复代码 #

import javax.swing.*;
import java.awt.*;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;

public class MainWindow {
    JFrame frame;
    JPanel showPanel;
    JPanel listPanel;
    JSplitPane contactsSplitPane;
    // 定义左侧面板最大宽度
    private static final int LIST_PANEL_MAX_WIDTH = 300;

    public void buildMainWindow() {       
        frame = new JFrame("Contacts");
        frame.setBackground(Color.WHITE);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
     
        showPanel = new JPanel();
        showPanel.setBackground(Color.WHITE);
            
        listPanel = new JPanel(){
            // 重写getMaximumSize固定宽度约束，避免布局修改返回值
            @Override
            public Dimension getMaximumSize() {
                return new Dimension(LIST_PANEL_MAX_WIDTH, Integer.MAX_VALUE);
            }
        };
        listPanel.setBackground(Color.LIGHT_GRAY);
            
            
        contactsSplitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT, listPanel, showPanel);
        contactsSplitPane.setOneTouchExpandable(true);
        contactsSplitPane.setDividerLocation(50);
        // 添加分割条位置监听，限制最大拖动位置
        contactsSplitPane.addPropertyChangeListener(JSplitPane.DIVIDER_LOCATION_PROPERTY, new PropertyChangeListener() {
            @Override
            public void propertyChange(PropertyChangeEvent evt) {
                int location = (int) evt.getNewValue();
                if (location > LIST_PANEL_MAX_WIDTH) {
                    contactsSplitPane.setDividerLocation(LIST_PANEL_MAX_WIDTH);
                }
            }
        });
         
        frame.setSize(1000, 1000);
        // 修正顺序：先加组件，再设置可见
        frame.add(BorderLayout.CENTER, contactsSplitPane);
        frame.setVisible(true);
    }
 
    public static void main (String [] args) {
        MainWindow mainWindow = new MainWindow ();
        mainWindow.buildMainWindow();
    }
}

补充说明 #

如果需要同时限制左侧面板的最小宽度，只需要在监听器里增加最小位置的判断即可，逻辑和最大宽度限制完全一致。不要依赖Swing组件默认的setMaximumSize/setMinimumSize方法做分割条的边界限制，这类方法的生效逻辑强依赖子组件的布局管理器实现，在JSplitPane、JScrollPane这类容器里大概率不会按预期工作。

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