本文介绍在 magicgui 中构建两个联动 combobox 的完整方法：当第一个下拉框值改变时，第二个下拉框的可选项自动更新，通过信号连接与动态 choices 函数协同实现。
本文介绍在 magicgui 中构建两个联动 combobox 的完整方法：当第一个下拉框值改变时，第二个下拉框的可选项自动更新，通过信号连接与动态 choices 函数协同实现。
在 magicgui 中实现级联（cascading）下拉框是常见但需注意细节的交互需求。核心思路是：让第二个 ComboBox 的 choices 参数绑定一个可调用函数，并在第一个 ComboBox 值变更时主动触发其选项重载。不同于静态 choices 列表，动态 choices 函数会接收当前 GUI 实例作为参数，从而可安全访问其他控件的当前值。
以下是一个完整、健壮的实现示例：
from magicgui import magicgui
# 定义层级映射关系：一级选项 → 对应的二级选项列表
choices_map = {
"Choice 1": ["First A", "First B", "First C"],
"Choice 2": ["Second A", "Second B", "Second C", "Second D"],
"Choice 3": ["Only one choice"],
}
# 动态 choices 函数：根据 box1 当前值返回 box2 的候选列表
def get_box2_choices(gui):
# 防御性检查：GUI 初始化完成前 parent 可能为 None
if gui.parent is None:
return []
# 安全获取 box1 的当前值（即使尚未初始化，也避免 KeyError）
selected_key = gui.parent.box1.value
return choices_map.get(selected_key, [])
@magicgui(
box1={"widget_type": "ComboBox", "choices": list(choices_map.keys())},
box2={"widget_type": "ComboBox", "choices": get_box2_choices},
call_button="Submit",
)
def widget(box1: str, box2: str) -> str:
"""处理用户选择并返回结果字符串"""
return f"Selected: {box1} → {box2}"
# 关键步骤：监听 box1 的值变化，触发 box2 重新加载选项
widget.box1.changed.connect(widget.box2.reset_choices)
✅ 关键要点说明：
-
get_box2_choices函数必须接受gui参数（magicgui 自动传入），并通过gui.parent访问父级 widget 实例； - 使用
choices_map.get(..., [])替代直接索引，防止因未选中初始值或异常状态引发KeyError； -
widget.box1.changed.connect(...)是响应式更新的核心——它确保每次box1值变更后，box2立即调用reset_choices()重新执行get_box2_choices； - 若需支持空选项或默认占位符（如
"-- Select --"），可在get_box2_choices返回前手动插入，例如return ["-- Select --"] + choices_map.get(..., [])； - 注意：该方案依赖
parent引用，因此不适用于独立调用的纯函数式 widget（如widget.show()后再连接信号），推荐始终通过@magicgui装饰器定义完整 GUI。
运行后，用户切换第一个下拉框时，第二个下拉框将实时刷新可用选项，真正实现低耦合、高响应的级联交互。
