JTable单元格编辑时自动扩展列宽：非键盘监听实现方案咨询

Great question—this is absolutely a standard need when working with JTables, and you’re totally right to steer clear of keyboard listeners. They’re not only clunky but also miss edge cases like pasting via right-click menu or programmatic edits.

The good news is you don’t have to rely solely on edit start/end listeners. Instead, you can customize the table’s cell editor to monitor changes in the editing component’s content in real time, then adjust the column width dynamically. Here’s how to do it properly:

Step-by-Step Implementation #

1. Create a Custom Cell Editor with Document Listener #

We’ll extend DefaultCellEditor (which uses a JTextField by default) and add a DocumentListener to the text field’s underlying document. This listener will trigger a column width adjustment every time the text changes—no matter how the change happens.

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

public class AutoResizeTableCellEditor extends DefaultCellEditor {
    private final JTextField textField;
    private final JTable table;
    private int currentColumn;

    public AutoResizeTableCellEditor(JTable table) {
        super(new JTextField());
        this.table = table;
        this.textField = (JTextField) getComponent();
        
        // Listen for any changes to the text field's content
        textField.getDocument().addDocumentListener(new DocumentListener() {
            @Override
            public void insertUpdate(DocumentEvent e) {
                updateColumnWidth();
            }

            @Override
            public void removeUpdate(DocumentEvent e) {
                updateColumnWidth();
            }

            @Override
            public void changedUpdate(DocumentEvent e) {
                updateColumnWidth();
            }
        });
    }

    @Override
    public Component getTableCellEditorComponent(JTable table, Object value, boolean isSelected, int row, int column) {
        currentColumn = column;
        return super.getTableCellEditorComponent(table, value, isSelected, row, column);
    }

    private void updateColumnWidth() {
        String currentText = textField.getText() != null ? textField.getText() : "";
        FontMetrics metrics = textField.getFontMetrics(textField.getFont());
        
        // Calculate exact width needed for the text, plus padding to avoid clipping
        int requiredWidth = metrics.stringWidth(currentText) + 12; // 12px padding for breathing room
        
        // Get the current column's width
        TableColumn column = table.getColumnModel().getColumn(currentColumn);
        int currentWidth = column.getWidth();

        // Only expand the column if the new text needs more space
        if (requiredWidth > currentWidth) {
            column.setPreferredWidth(requiredWidth);
            table.doLayout(); // Force the table to refresh its layout immediately
        }

        // Optional: Allow column to shrink when text gets shorter (set a minimum width first)
        // int minWidth = 50;
        // if (requiredWidth < currentWidth && requiredWidth >= minWidth) {
        //     column.setPreferredWidth(requiredWidth);
        //     table.doLayout();
        // }
    }
}

2. Attach the Editor to Your Column(s) #

Once you’ve created the custom editor, assign it to any columns where you want auto-resizing behavior:

// Example: Apply to the first column in your table
JTable yourTable = new JTable();
yourTable.getColumnModel().getColumn(0).setCellEditor(new AutoResizeTableCellEditor(yourTable));

Key Notes #

• Covers All Editing Scenarios: Since we’re listening to the document itself, this works for typing, pasting, cutting, and even programmatic changes to the editor’s text.
• Adjust Padding: Tweak the +12 value in requiredWidth to add more or less space around the text, depending on your UI preferences.
• Auto-Resize Mode: If your table uses AUTO_RESIZE_OFF (no automatic column resizing), the width changes will affect only the target column. If you use other modes (like AUTO_RESIZE_SUBSEQUENT_COLUMNS), adjusting one column will shrink/grow others—adjust this setting based on your layout needs.
• Minimum Column Width: If you enable the optional shrink behavior, set a reasonable minimum width to prevent columns from becoming too narrow to read.

This approach is clean, adheres to Swing’s design patterns, and solves the exact problem you’re facing without relying on hacky keyboard listeners.

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