SuperAPI AI 工具集

wiring-vizro-actions

数据与分析

查看项目

更新于 10-16 00:22

技能介绍

用途:为 Vizro 仪表盘添加跨筛选(cross-filter)、跨高亮、下钻(drill-through)和数据导出等高级交互。核心概念为 Source → Control → Target:源组件(vm.Graph、vm.AgGrid 等携带点击数据的组件)触发 va.set_control,将值写入带显式 id 的中间控件(vm.Filter 或 vm.Parameter),再由控件更新目标数据组件。控件始终显式连接,组件间不直接相连,因此交互可组合(多源接同一控件,或一源接多控件)。

内置动作:va.export_data() 由 vm.Button 触发,导出当前页面数据为 CSV(遵循筛选);va.set_control(control=..., value=...) 由 vm.Graph 或 vm.AgGrid 触发。内置动作直接传入 actions=,若用 vm.Action 包裹会报错。

命名的交互模式:1 层级下钻(跨页,需 2–3 级层级且详情有独立页面);2 单页下钻(容器,2 级层级详情放容器内);3 对比聚焦(跨高亮,比较单一实体而保留上下文);4 多维切片(2 个以上分类维度,动作链设多个 Filter);5 数据导出(分析师需下载筛选后数据)。模式 1–4 至多选一个作主交互,导出可按需独立叠加。若无明显层级、无需对比聚焦、维度不足两类,则标准侧边栏 vm.Filter 已足够。

限制与注意:视图型仪表盘、简单筛选、小数据集(少于约 5 组)、单页超过 2 个交互模式时不宜用高级交互;filter_interaction 已弃用,改用 va.set_control;非位置轴列跨筛选需加 custom_data;跨高亮 Parameter 设 visible=False;跨页需 show_in_url=True,否则构建报错;下钻目标页用 vm.Flex 布局并配返回按钮与操作提示 header;highlight 选项首项加 "NONE"。

关键导入:import vizro.actions as va;import vizro.models as vm;import vizro.plotly.express as px;from vizro.tables import dash_ag_grid;from vizro.models.types import capture。更完整的模式模板、代码与常见错误详见 actions-reference.md。