Java CardLayout 怎样按名称切换容器中的卡片

Java Swing 里要在同一个区域放入多个面板，并根据菜单或按钮显示其中一个，CardLayout 的关键不是给组件设置显示状态，而是给每个组件绑定一个字符串名称，再让同一个布局对象调用 show(parent, name)。名称完全匹配时切换到对应卡片；名称不存在时不会抛出“找不到卡片”的异常，而是什么也不改变。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/CardLayout.html

把 CardLayout 保存成一个变量，把卡片容器作为 show 的第一个参数，并在添加组件时使用同一套名称常量，就能按名称切换。首个加入容器的组件默认是初次显示的卡片。

名称绑定在添加卡片时完成

CardLayout 把容器里的每个组件当作一张卡片。名称不是 JPanel 的 setName 属性，而是添加组件时传给布局管理器的字符串约束。推荐直接使用 add(component, constraint) 的形式：

CardLayout layout = new CardLayout();
JPanel cards = new JPanel(layout);

JPanel overview = new JPanel();
JPanel details = new JPanel();

// 第二个参数是 CardLayout 用来定位卡片的字符串键
cards.add(overview, "overview");
cards.add(details, "details");

// show 的第一个参数必须是承载这些卡片的同一个容器
layout.show(cards, "details");

这里的 "overview" 和 "details" 会进入 CardLayout 的名称表。Oracle API 说明，约束对象必须是字符串；如果传入其他类型，会触发 IllegalArgumentException。因此名称应当当作组件注册契约来维护，而不是临时拼接。

用同一个布局对象按名称切换

实际界面通常把导航按钮放在卡片容器外面。事件监听器只需要调用布局对象的 show 方法；不要在每次点击时新建一个 CardLayout，否则新对象并不知道原容器登记过哪些卡片。

import java.awt.BorderLayout;
import java.awt.CardLayout;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;

JFrame frame = new JFrame("CardLayout 示例");
CardLayout layout = new CardLayout();
JPanel cards = new JPanel(layout);

JPanel home = new JPanel();
home.add(new JLabel("首页卡片"));
JPanel settings = new JPanel();
settings.add(new JLabel("设置卡片"));

// 名称建议集中成常量，避免按钮和注册处出现拼写漂移
final String HOME = "home";
final String SETTINGS = "settings";
cards.add(home, HOME);
cards.add(settings, SETTINGS);

JButton openSettings = new JButton("打开设置");
openSettings.addActionListener(event -> {
    // 事件发生时切换同一个 cards 容器中的命名卡片
    layout.show(cards, SETTINGS);
});

JButton openHome = new JButton("返回首页");
openHome.addActionListener(event -> {
    // 返回动作仍然使用同一个布局实例和父容器
    layout.show(cards, HOME);
});

JPanel navigation = new JPanel();
navigation.add(openHome);
navigation.add(openSettings);
frame.add(navigation, BorderLayout.NORTH);
frame.add(cards, BorderLayout.CENTER);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.pack();
frame.setVisible(true);

这个写法把“卡片注册”和“按钮导航”分开：注册阶段决定名称，事件阶段只消费名称。show 会翻到使用该名称添加的组件；如果没有对应组件，API 的行为是“不做任何事情”，所以界面不变化并不一定是 Swing 绘制失败。

初始卡片、名称错误和顺序方法

初次显示时，最先加入 CardLayout 的组件是可见卡片。若希望启动后显示设置页，可以调整添加顺序，或在界面完成组装后显式调用 layout.show(cards, SETTINGS)。显式调用更容易表达启动状态，但仍然要保证名称已经完成注册。

常见的“不切换”原因有三个：

• 添加时使用了 "setting"，点击时却传入 "settings"；名称是精确匹配，不会自动纠正。
• 调用 show 时传入的不是承载卡片的父容器，或者布局对象不是注册卡片时的那个实例。
• 把名称写成动态字符串后没有统一管理，导致按钮和注册处的空格、大小写或拼写出现差异。

如果需求只是“下一张/上一张”而不关心具体业务名称，可以使用 next(parent) 和 previous(parent)；前者到达末尾后会回到第一张，后者到达第一张后会回到最后一张。需要明确打开某个功能页时，仍应优先使用 show。

一张表记住 CardLayout 的切换规则

可以把名称常量、卡片容器和布局对象放在同一个界面控制器中，按钮只引用常量。这样做的价值不在于代码更短，而是把“卡片存在”和“导航目标”放进同一份可维护契约里。

相关问题

CardLayout 能同时显示两张卡片吗？

它的设计是同一容器一次显示一张卡片。如果需要并排区域，应拆成多个容器，分别使用布局管理器。

名称不存在时应该捕获什么异常？

show 对不存在的名称不会抛出专门异常，而是保持当前显示状态。应用层若要求导航一定成功，可以在注册时维护名称集合，再在调用前自行判断。