本文介绍在 magicgui 中构建两个联动下拉框（ComboBox）的方法：第二个下拉框的可选项根据第一个下拉框的当前选值动态更新，利用 changed 信号与 reset_choices 方法实现响应式依赖。
本文介绍在 magicgui 中构建两个联动下拉框（combobox）的方法：第二个下拉框的可选项根据第一个下拉框的当前选值动态更新，利用 `changed` 信号与 `reset_choices` 方法实现响应式依赖。
在 magicgui 中实现级联下拉框（Cascading ComboBox）是常见但需注意细节的交互需求。核心思路是：将第二个 ComboBox 的 choices 设为一个接收 GUI 实例的函数，并通过监听第一个 ComboBox 的 changed 事件，主动触发第二个 ComboBox 的 reset_choices() 方法来刷新选项列表。
以下是一个完整、健壮的实现示例：
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 函数必须接收 widget 所属的 gui 实例（即 magicgui 函数包装器）
def get_box2_choices(gui):
# 防御性检查：GUI 初始化完成前 parent 可能为 None，box1 尚未就绪
if gui.parent is None or not hasattr(gui.parent, 'box1'):
return []
try:
selected_key = gui.parent.box1.value
return choices_map.get(selected_key, [])
except (AttributeError, KeyError):
return []
@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)
# （可选）初始化后手动触发一次，确保 box2 显示首个有效选项
if widget.box1.value and widget.box2.choices:
widget.box2.reset_choices()
✅ 关键要点说明：
-
choices参数支持函数签名Callable[[magicgui.widgets.Container], Sequence]，该函数接收整个 GUI 容器（即widget实例），因此可通过gui.parent.box1.value获取联动源控件的当前值； - 必须显式调用
widget.box1.changed.connect(widget.box2.reset_choices)建立信号连接——magicgui 不会自动推断依赖关系； - 初始化阶段
gui.parent可能为None，务必添加空值检查，避免AttributeError； -
reset_choices()会重新调用choices函数并更新下拉菜单，同时保留当前值（若仍合法）或自动设为首个选项； - 若希望二级 ComboBox 初始状态为空或禁用，可在
get_box2_choices中返回空列表[]，并在box1未选时保持box2.enabled = False（需额外控制，此处未展开）。
该方案简洁、可扩展性强，适用于多级联动、配置驱动界面等场景。只需维护 choices_map 字典结构，即可灵活适配业务逻辑变化。
