应用自定义BasicLookAndFeel后JTextField删除功能失效问题

我在给Swing应用添加自定义的BasicLookAndFeel后，发现JTextField不再响应Backspace/Delete删除操作了，以下是补全后的可复现代码：

import javax.swing.*;
import javax.swing.plaf.ColorUIResource;
import javax.swing.plaf.basic.BasicLookAndFeel;
import java.awt.*;
import java.util.logging.Logger;

public class App2 {
    private static final Logger log = Logger.getLogger(App2.class.getCanonicalName());

    public static void main(String args[]) {
        setUI();
        JFrame f = new JFrame("Test TextField");
        f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        f.setSize(300, 200);
        f.setLayout(new FlowLayout());
        
        JTextField textField = new JTextField(20);
        textField.setText("Try deleting this text");
        f.add(textField);
        
        f.setVisible(true);
    }

    private static void setUI() {
        try {
            UIManager.setLookAndFeel(new BasicLookAndFeel() {
                @Override
                protected void initComponentDefaults(UIDefaults table) {
                    super.initComponentDefaults(table);
                    // 自定义了文本框的颜色属性
                    table.put("TextField.background", new ColorUIResource(Color.LIGHT_GRAY));
                    table.put("TextField.foreground", new ColorUIResource(Color.DARK_GRAY));
                }

                @Override
                public String getName() {
                    return "Custom Basic LAF";
                }

                @Override
                public String getID() {
                    return "CustomBasic";
                }

                @Override
                public String getDescription() {
                    return "Custom Basic Look and Feel";
                }

                @Override
                public boolean isNativeLookAndFeel() {
                    return false;
                }

                @Override
                public boolean isSupportedLookAndFeel() {
                    return true;
                }
            });
        } catch (UnsupportedLookAndFeelException e) {
            log.severe("Failed to set LAF: " + e.getMessage());
        }
    }
}

问题根源 #

我之前踩过这个坑，问题出在自定义BasicLookAndFeel时，虽然调用了super.initComponentDefaults(table)，但默认的初始化可能没有正确加载JTextField所需的输入映射（InputMap）和动作映射（ActionMap）。BasicTextFieldUI完全依赖这两个映射来处理按键操作——包括Backspace删除前一个字符、Delete删除后一个字符这些基础功能。如果你的自定义LAF里缺失了这些映射配置，文本框自然就识别不了删除按键了。

两种可行的解决方案 #

方案1：直接复用默认Basic LAF的完整映射 #

这种方法最省心，直接把默认BasicLookAndFeel里的文本框相关映射复制过来，这样不仅能解决删除键问题，还能保留所有默认的文本框按键功能（比如复制、粘贴、全选等）：

@Override
protected void initComponentDefaults(UIDefaults table) {
    super.initComponentDefaults(table);
    // 保留你的自定义颜色设置
    table.put("TextField.background", new ColorUIResource(Color.LIGHT_GRAY));
    table.put("TextField.foreground", new ColorUIResource(Color.DARK_GRAY));
    
    // 实例化一个默认的BasicLookAndFeel，获取它的组件默认配置
    BasicLookAndFeel defaultBasicLAF = new BasicLookAndFeel();
    UIDefaults defaultDefaults = new UIDefaults();
    defaultBasicLAF.initComponentDefaults(defaultDefaults);
    
    // 把默认的文本框输入映射和动作映射复制到当前自定义LAF的配置中
    table.put("TextField.inputMap", defaultDefaults.get("TextField.inputMap"));
    table.put("TextField.actionMap", defaultDefaults.get("TextField.actionMap"));
}

方案2：手动添加删除键的绑定 #

如果你只需要修复删除键功能，不想引入其他默认配置，可以手动为输入映射添加Backspace和Delete的绑定，并关联对应的动作：

@Override
protected void initComponentDefaults(UIDefaults table) {
    super.initComponentDefaults(table);
    // 自定义颜色
    table.put("TextField.background", new ColorUIResource(Color.LIGHT_GRAY));
    table.put("TextField.foreground", new ColorUIResource(Color.DARK_GRAY));
    
    // 初始化输入映射，绑定删除按键
    InputMap inputMap = (InputMap) table.get("TextField.inputMap");
    if (inputMap == null) {
        inputMap = new InputMap();
        table.put("TextField.inputMap", inputMap);
    }
    inputMap.put(KeyStroke.getKeyStroke("BACK_SPACE"), "delete-previous");
    inputMap.put(KeyStroke.getKeyStroke("DELETE"), "delete-next");
    
    // 初始化动作映射，关联对应的删除动作（使用Swing自带的默认动作）
    ActionMap actionMap = (ActionMap) table.get("TextField.actionMap");
    if (actionMap == null) {
        actionMap = new ActionMap();
        table.put("TextField.actionMap", actionMap);
    }
    actionMap.put("delete-previous", new DefaultEditorKit.DeletePrevCharAction());
    actionMap.put("delete-next", new DefaultEditorKit.DeleteNextCharAction());
}

测试验证 #

修改后重新运行代码，你会发现JTextField现在可以正常响应Backspace和Delete键的删除操作了。如果需要其他文本编辑功能，方案1会更全面，推荐优先使用。

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