本文介绍如何通过修改底层 plotly.graph_objects 追加迹（trace）的 visible='legendonly' 属性，实现 plotly express 生成的条形图中部分数据系列默认隐藏、仅通过图例交互激活的效果。
本文介绍如何通过修改底层 plotly.graph_objects 追加迹（trace）的 visible='legendonly' 属性，实现 plotly express 生成的条形图中部分数据系列默认隐藏、仅通过图例交互激活的效果。
Plotly Express（PX）本身不直接提供“默认隐藏某几根柱子”的参数，但其返回的 Figure 对象是标准的 plotly.graph_objects.Figure 实例，因此可借助底层 API 灵活控制每条迹（trace）的可见性状态。
核心思路是：
- 使用 px.bar() 正常创建图表；
- 遍历 fig.data 中的各条迹（每条对应一个分类/变量）；
- 将目标迹的 visible 属性设为 'legendonly' —— 此值表示该迹初始不可见，但保留在图例中，用户点击图例项时可手动显示/隐藏。
以下是一个完整示例（假设原始 DataFrame 含三列 A、B、C，需默认仅显示 A，隐藏 B 和 C）：
import plotly.express as px
import plotly.graph_objects as go
import pandas as pd
# 示例数据：宽格式（每列为一个变量）
df = pd.DataFrame({
'x': ['Group 1', 'Group 2', 'Group 3'],
'A': [10, 15, 12],
'B': [8, 11, 9],
'C': [6, 13, 7]
})
# 将宽格式转为长格式（PX bar 要求）
df_long = df.melt(id_vars='x', var_name='category', value_name='value')
# 创建基础条形图（按 category 分组）
fig = px.bar(df_long, x='x', y='value', color='category', barmode='group')
# 【关键步骤】遍历所有 trace，按 name 匹配并设置 visible='legendonly'
for i, trace in enumerate(fig.data):
if trace.name in ['B', 'C']: # 指定需默认隐藏的类别
fig.data[i].visible = 'legendonly'
fig.update_layout(
title="条形图：B 和 C 默认隐藏，点击图例激活",
legend_title_text="数据系列"
)
fig.show()✅ 效果说明：运行后图表仅显示 A 对应的柱子；图例中 B 和 C 项呈灰色（带斜线图标），点击任一即可即时显示对应柱子，再次点击则隐藏。
⚠️ 注意事项：
- visible='legendonly' 仅影响初始渲染状态，不影响图例交互逻辑，完全兼容 Plotly 的原生图例切换行为；
- 若使用 color 参数映射离散变量（如本例），trace.name 即为对应 category 值；若用 pattern_shape 或其他分组方式，请根据 trace.name 实际值调整匹配逻辑；
- 不建议直接修改 fig.data[i].visible = False（完全禁用），因其会从图例中移除该项，失去交互入口；
- 此方法适用于所有 PX 图表（px.line、px.scatter 等），原理通用。
通过这一轻量级改造，你无需重写绘图逻辑，即可在保持 Plotly Express 简洁语法优势的同时，精准控制各数据系列的默认可见性，显著提升多系列对比图表的可读性与交互体验。
