17370845950

使用 `fig.add_trace()` 动态添加 violin 图轨迹时，可通过 `name` 参数直接为每条轨迹指定图例标签，避免默认显示为“trace 1”“trace 2”等无意义名称。

在 Plotly 中，图例项（legend entry）的显示名称默认由轨迹（trace）的 name

属性决定。若未显式设置该参数，Plotly 会自动分配如 "trace 0"、"trace 1" 这样的占位名称——这正是你在循环中遇到的问题。

解决方法非常简洁：在调用 go.Violin() 时，将 name 作为关键字参数传入。通常你已有对应每组数据的语义化标识（例如类别名、年份、实验组名等），只需将其与 data_line 和 color 一同解包即可：

from plotly import graph_objects as go
from plotly.colors import n_colors

# 假设 hist_data 是一个包含多个数据数组的列表
# names 是与之对应、长度相同的图例标签列表（如 ['Group A', 'Group B', ...]）
names = [f"Sample {i+1}" for i in range(len(hist_data))]  # 示例命名逻辑

colors = n_colors('rgb(2, 200, 200)', 'rgb(300, 10, 10)', len(hist_data), colortype='rgb')

fig = go.Figure()
for data_line, color, name in zip(hist_data, colors, names):
    fig.add_trace(go.Violin(
        x=data_line,
        line_color=color,
        name=name,  # ✅ 关键：显式指定图例名称
        showlegend=True  # 可选：确保该轨迹出现在图例中（默认为 True）
    ))

fig.update_traces(orientation='h', side='positive', width=3, points=False)
fig.update_layout(
    xaxis_showgrid=False,
    xaxis_zeroline=True,
    legend_title="Distribution Groups",  # 可选：添加图例标题提升可读性
)

⚠️ 注意事项：

• name 必须是字符串类型；若传入 None 或空字符串，Plotly 仍可能回退到默认 trace 编号。
• 若某轨迹设置了 showlegend=False，即使有 name 也不会出现在图例中。
• 所有 name 值在图例中需具有区分度；重复的 name 会导致图例项合并（仅显示一次），但轨迹本身仍独立渲染。
• 如需后续动态更新图例名，可通过 fig.data[i].name = "new_name" 修改，并调用 fig.update_layout() 触发重绘。

通过这一方式，你不仅能获得语义清晰的图例，还能为交互（如 hover 提示、图例点击筛选）打下良好基础——这是构建专业级可视化图表的关键细节之一。