萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Java Swing 面板動態刷新:按鈕點擊切換面板內容實現

場景

左側導航按鈕,點擊後右側內容面板動態更新顯示不同信息 (如歡迎頁、設置頁、幫助頁)。

核心思路:CardLayout (官方推薦)

CardLayout 專為「卡片堆疊、單顯示一張」設計,完美契合此場景,無需手動增刪組件。

完整可運行範例

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

public class PanelSwitchDemo extends JFrame {
    private final CardLayout cardLayout = new CardLayout();
    private final JPanel contentPanel = new JPanel(cardLayout); // 容器使用 CardLayout
    private final JPanel navPanel = new JPanel(new GridLayout(0, 1)); // 垂直按鈕

    public PanelSwitchDemo() {
        setTitle("面板切換演示");
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setLayout(new BorderLayout());

        // 1. 建立多個內容面板 (卡片)
        JPanel welcomePanel = createPanel("歡迎頁面", "歡迎使用系統!\n請選擇左側功能。", Color.WHITE);
        JPanel settingsPanel = createPanel("設置頁面", "這裡是設置內容...\n[選項1] [選項2]", new Color(240, 240, 255));
        JPanel helpPanel = createPanel("幫助頁面", "常見問題:\nQ: 如何聯繫客服?\nA: 撥打 400-xxx-xxxx", new Color(255, 248, 220));

        // 2. 添加到卡片容器,指定唯一標識
        contentPanel.add(welcomePanel, "welcome");
        contentPanel.add(settingsPanel, "settings");
        contentPanel.add(helpPanel, "help");

        // 3. 建立導航按鈕,綁定切換動作
        addNavButton("歡迎", "welcome");
        addNavButton("設置", "settings");
        addNavButton("幫助", "help");

        // 4. 佈局
        add(navPanel, BorderLayout.WEST);
        add(contentPanel, BorderLayout.CENTER);

        pack();
        setLocationRelativeTo(null); // 居中
        setVisible(true);
    }

    private JPanel createPanel(String title, String text, Color bg) {
        JPanel panel = new JPanel(new BorderLayout());
        panel.setBackground(bg);
        panel.setBorder(BorderFactory.createTitledBorder(title));
        JLabel label = new JLabel("" + text.replace("\n", "
") + ""); label.setHorizontalAlignment(SwingConstants.CENTER); panel.add(label, BorderLayout.CENTER); return panel; } private void addNavButton(String text, final String cardName) { JButton btn = new JButton(text); btn.addActionListener(e -> cardLayout.show(contentPanel, cardName)); // 核心:顯示指定卡片 navPanel.add(btn); } public static void main(String[] args) { SwingUtilities.invokeLater(PanelSwitchDemo::new); // EDT 安全啟動 } }

關鍵點解析

  1. CardLayout:內部維護組件堆疊,show(parent, name) 瞬時切換,無閃爍、無佈局重排
  2. 組件復用:所有面板一次性創建、長期駐留內存,切換極快 (適合狀態較少、切換頻繁)
  3. 事件分發執行緒 (EDT):SwingUtilities.invokeLater 確保 UI 創建在 EDT,避免線程安全問題

替代方案對比

方案優點缺點適用場景
CardLayout (推薦)官方標準、效能最好、代碼最簡潔所有面板常駐內存面板數少 (≤10)、狀態簡單、頻繁切換
remove/add + revalidate/repaint靈活、按需創建釋放內存代碼繁瑣、易閃爍、需手動管理生命週期面板數多、內容複雜、內存敏感
JTabbedPane自帶標籤 UI、鍵盤導航UI 風格固定、難以完全自定義標籤頁式交互
JSplitPane + 動態替換可調整分割比例複雜度高主從結構、可調整比例

手動 remove/add 實現 (不推薦新手,但理解原理)

// 內容面板使用 BorderLayout 或 FlowLayout
JPanel contentPanel = new JPanel(new BorderLayout());

// 切換邏輯
void switchPanel(JPanel newPanel) {
    contentPanel.removeAll();           // 1. 移除舊組件
    contentPanel.add(newPanel, BorderLayout.CENTER); // 2. 添加新組件
    contentPanel.revalidate();          // 3. 重新佈局 (關鍵!)
    contentPanel.repaint();             // 4. 重繪 (關鍵!)
}

必須調用 revalidate() (觸發佈局管理器重新計算) 和 repaint() (觸發重繪),否則介面不更新。

現代替代:JavaFX

新專案建議使用 JavaFX:

// JavaFX 等效 CardLayout
StackPane root = new StackPane();
Node welcome = createWelcomeView();
Node settings = createSettingsView();
Node help = createHelpView();
root.getChildren().addAll(welcome, settings, help);

// 切換:控制 visible 屬性
welcome.setVisible(true);
settings.setVisible(false);
help.setVisible(false);

// 或用 TabPane (對應 JTabbedPane)
TabPane tabPane = new TabPane(
    new Tab("歡迎", welcome),
    new Tab("設置", settings),
    new Tab("幫助", help)
);
copyright © 萬盛學電腦網 all rights reserved