如何为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
相关产品推荐
相关产品推荐

