Swing 列表框與組合框實戰：JList 與 JComboBox 核心用法

元件對比

基礎範例

public class ListCombo extends JPanel {
    public ListCombo() {
        setLayout(new GridLayout(2, 1));

        // JList：一行代碼建構，外加 JScrollPane
        JList list = new JList(ButtonGroups.ids); // String[] 來源
        add(new JScrollPane(list));

        // JComboBox：動態添加 100 項
        JComboBox combo = new JComboBox();
        for (int i = 0; i < 100; i++)
            combo.addItem(String.valueOf(i));
        add(combo);
    }
    // main()...
}

進階技巧

1. 自定義渲染器

list.setCellRenderer(new DefaultListCellRenderer() {
    @Override public Component getListCellRendererComponent(
        JList list, Object value, int index, boolean sel, boolean focus) {
        JLabel label = (JLabel) super.getListCellRendererComponent(...);
        if (value instanceof User) {
            User u = (User) value;
            label.setText(u.getName() + " (" + u.getEmail() + ")");
            label.setIcon(userIcon);
        }
        return label;
    }
});

2. 模型分離

// 共享模型：列表與下拉框同步
DefaultListModel model = new DefaultListModel<>();
model.addElement("Item 1");
JList list = new JList(model);
JComboBox combo = new JComboBox(model); // 同一模型

3. 事件處理

// JList 選擇事件
list.addListSelectionListener(e -> {
    if (!e.getValueIsAdjusting()) {
        String selected = list.getSelectedValue();
        // 處理選擇...
    }
});

// JComboBox 動作事件
combo.addActionListener(e -> {
    String selected = (String) combo.getSelectedItem();
    // 處理選擇...
});

4. 可編輯組合框

combo.setEditable(true);
// 可選：自動完成支援 (第三方庫或自定義 DocumentFilter)

常見坑點

• 忘記 JScrollPane：JList 不自動滾動，資料多時必須包裹。
• 大量資料效能：>1000 項建議使用 DefaultListModel 分批載入或虛擬化列表。
• 泛型警告：JComboBox (Java 7+) 避免未檢查轉型。

結語

JList 與 JComboBox 是 Swing 選擇類元件的雙子星。**記住：列表需自備滾動窗格，下拉框內建滾動**。善用模型分離與自定義渲染器，能輕鬆應對複雜業務呈現需求。