You need to enable JavaScript to run this app. 如何为Plotly Express的px.Treemap添加含色阶值的自定义文本标注
优惠活动
大模型
产品
解决方案
定价
更多

如何为Plotly Express的px.Treemap添加含色阶值的自定义文本标注

Plotly Express 矩形树图自定义区块标注实现方案

针对当前示例代码中需要同时展示层级标签、色阶绑定的salary实际值、带自定义前缀的父级占比标注的需求,有两类可直接落地的实现方法:

方法1:使用内置texttemplate模板动态生成标注

这种方法不需要改动原始数据结构,直接在图表渲染层按照格式要求拼接展示内容,操作最便捷。
核心实现逻辑:

  • 在创建treemap时,通过custom_data参数将需要展示的色阶绑定字段(也就是salary)传入trace,供后续模板调用
  • 替换默认的textinfo配置为texttemplate,按照需求拼接每部分展示内容,支持直接在文本段添加自定义说明前缀

对应修改后的示例代码:

# 创建treemap时传入自定义数据字段
fig = px.treemap(
    df_plot,
    values='count',
    color='salary',
    color_continuous_scale='balance',
    color_continuous_midpoint=avg_salary,
    path=['type','name'],
    custom_data=['salary']  # 将salary值存入trace,供模板调用
)

# 自定义标注格式,匹配展示需求
fig.data[0].texttemplate = (
    '%{label}<br>'  # 展示对应层级的区块名称
    '薪资值: $%{customdata[0]:,.0f}<br>'  # 展示色阶对应的salary实际值
    'Percent of Total: %{percentParent:.1%}'  # 带自定义前缀的父级占比
)

模板支持的可调用变量说明:

  • %{label}:自动匹配path层级中对应节点的名称
  • %{customdata[0]}:取传入的第一个自定义字段值,也就是需要展示的salary,可通过格式化规则调整数值展示精度、格式
  • %{percentParent}:自动计算当前区块相对于父级的占比,支持百分比格式化

方法2:提前在数据帧中构造完整标注文本

这种方法适合标注逻辑较复杂的场景(比如需要根据数值大小动态调整文本内容、添加判断逻辑),灵活度最高。
核心实现逻辑:

  • 在分组聚合后的df_plot中,按照最终需要展示的标注格式逐行拼接完整文本,存入新的列
  • 创建treemap时将这列自定义文本通过text参数传入,将textinfo设置为text即可直接展示拼接好的内容

示例代码片段:

# 提前在数据帧中构造完整标注文本
df_plot['custom_tip'] = (
    df_plot['name'] + '<br>'
    + '区块薪资: $' + df_plot['salary'].map(lambda x: f"{x:,.0f}") + '<br>'
    + 'Percent of Total: '
)

# 创建treemap时传入自定义文本列
fig = px.treemap(
    df_plot,
    values='count',
    color='salary',
    color_continuous_scale='balance',
    color_continuous_midpoint=avg_salary,
    path=['type','name'],
    text='custom_tip'
)
fig.data[0].textinfo = 'text'
# 占比数值可在渲染后通过trace数据补充拼接,无需手动提前计算聚合节点值

落地注意事项

  • Treemap的父级聚合节点(比如path顶层的type分类大区块),Plotly会自动计算对应的salary聚合值、占比数值,无需手动提前计算节点的汇总结果
  • 如果小区块文本显示拥挤,可通过fig.update_traces(textfont_size=11)调整字体大小,或针对不同层级的节点设置差异化的文本显示规则
  • 原示例中导入的matplotlib在Plotly treemap渲染流程中无实际作用,可移除减少冗余依赖

内容的提问来源于stack exchange,提问作者Coldchain9

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 20:57:04