左側導航按鈕,點擊後右側內容面板動態更新顯示不同信息 (如歡迎頁、設置頁、幫助頁)。
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 安全啟動
}
}
show(parent, name) 瞬時切換,無閃爍、無佈局重排SwingUtilities.invokeLater 確保 UI 創建在 EDT,避免線程安全問題| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| CardLayout (推薦) | 官方標準、效能最好、代碼最簡潔 | 所有面板常駐內存 | 面板數少 (≤10)、狀態簡單、頻繁切換 |
| remove/add + revalidate/repaint | 靈活、按需創建釋放內存 | 代碼繁瑣、易閃爍、需手動管理生命週期 | 面板數多、內容複雜、內存敏感 |
| JTabbedPane | 自帶標籤 UI、鍵盤導航 | UI 風格固定、難以完全自定義 | 標籤頁式交互 |
| JSplitPane + 動態替換 | 可調整分割比例 | 複雜度高 | 主從結構、可調整比例 |
// 內容面板使用 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 等效 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)
);