jquick-pdf 生成渠道来源漏斗 PDF:暖橙低饱和渐变漏斗图的风格选型记录
摘要(meta description):信用平台四类注册渠道的获客贡献漏斗,jquick-pdf 4.7.0+(Apache-2.0 协议)JChartType.Funnel 渲染。配色走高饱和主色直出还是低饱和同色系渐变,图表居中放大还是缩图配读法栏,抬头用深底还是浅底——这篇以风格对比表贯穿全文,逐项展开每个选择的代价,附完整 Java 源码与模板。
标签:jquick-pdf、Java PDF、报表开发、漏斗图
官网示例:
真实渲染效果预览
以下为上述代码 + 模板真实运行生成的 PDF 首屏预览(由 jquick-pdf 渲染输出,非示意图):

动手前先定风格,再写代码
漏斗图是这份 JQuickBiz25ChannelFunnelTest 里最省事的图表类型,四条数据一次成型。真正花时间的是风格:市场部的报告和财务风控报告不是一个气质,配色、版式、抬头的每个决定都得先问"这份报告给谁看"。我把做这份 Demo 时权衡过的四组风格选择列成对照表,正文逐项展开。输出 D:\test\biz\25_channel_funnel.pdf,主题暖调深橙 #BF360C。(效果预览图 alt:jquick-pdf 渠道来源漏斗分析 PDF,暖橙主题,浅橙抬头卡与左肩粗线,285px 漏斗图配右侧漏斗读法栏,渠道投放明细表)
| 选型项 | 路线 A(本 Demo 采用) | 路线 B(备选) |
|---|---|---|
| 图表配色 | 低饱和棕色系渐变四色 | 主色 #BF360C 高饱和直出 |
| 图表版式 | 285px 缩图 + 右侧读法栏 | 700pt 大图居中独占 |
| 抬头 | 浅橙底 + 左肩 6px 粗线 | 深色实底白字 |
| 分节标题 | 下划线式(underline) | 色条底 / 左肩线式 |
选型一:配色,高饱和主色还是同色系渐变
// 与主色 #BF360C 同色系的低饱和棕色渐变,避免高饱和跳色
.colors(
new Color(140, 62, 44),
new Color(166, 84, 58),
new Color(191, 108, 82),
new Color(214, 141, 117)
)
源码注释把选型理由写明了:与主色 #BF360C 同色系的低饱和棕色渐变,避免高饱和跳色。四个 RGB 值从 (140,62,44) 到 (214,141,117) 一路变浅,漏斗从宽到窄的同时颜色从深到浅,层级感和宽度递减是同一个方向。我做对比版时直接四层全用 #BF360C,四条只靠宽度区分,缩图状态下第二层和第三层的边界糊在一起;换成高饱和彩虹渐变(红橙黄)又和模板的政务气质打架。低饱和渐变是两个极端之间的稳妥解:同色相保证整页统一,明度阶梯保证相邻层可分辨。汇报场景选路线 B 的高饱和可能反而抓眼球,但这份是内部投放分析报告,克制一点没错。
选型二:版式,大图居中还是缩图配读法
这是这份模板最有性格的决定:
<div style="display:flex; justifyContent:space-between; marginBottom:10px">
<div style="width:285px">
<div style="display:flex; justifyContent:center">
<svg style="width:285px">${svg}</svg>
</div>
</div>
<div style="width:265px">
<h3 style="color:#BF360C; fontSize:12; bold:true; marginBottom:6px">'漏斗读法'</h3>
<list style="listStyleType:disc; paddingLeft:14px; fontSize:9">
<li style="marginBottom:5px">'自上而下为四类注册渠道,条越长代表新增注册量越大。'</li>
<li style="marginBottom:5px">'广告投放为第一大来源,贡献约四成新增注册。'</li>
<li style="marginBottom:5px">'老客推荐量最小,但单客获取成本最低。'</li>
<li style="marginBottom:5px">'渠道合作居中,性价比介于两者之间。'</li>
</list>
</div>
</div>
漏斗 SVG 压到 285px 宽放在左栏,右边 265px 配一个"漏斗读法"小标题加四条圆点说明。路线 B 是其他 Demo 常见的 700pt 居中大图。我两种都跑过:大图版的漏斗确实气派,但四层漏斗的信息量撑不满 700pt 宽的版面,图下面是一大块空白感;缩图配读法版把"怎么看这张图"的四句话(条越长注册量越大、广告投放占四成、老客推荐成本最低、渠道合作居中)顶到图旁边,第一次看的人不用滚到第三节找结论。选择的关键在漏斗图的数据量——只有四层时缩图配读法是密度更高的解法,层次多到七八层就得给大图了。注意 svg 也是只写 width:285px 不写高度,等比缩放的约定不变。图注那行"图 1 2024年信用平台新增注册用户渠道漏斗(单位:人;数据来源:用户增长看板)"压在双栏下面,9 号斜体灰字——双栏排版容易让人忘了图和读法栏是一个整体,图注把两者在版面上缝住。
选型三:抬头,深底白字还是浅底粗线
路线 B 的深色实底抬头在政务报告里好用,这份模板没选它:
<div style="background:#FDF0EA; border:1px solid #E8CDBF; borderLeft:6px solid #BF360C; borderRadius:4px; padding:12px; marginBottom:12px; keepTogether:true">
<h1 style="color:#BF360C; fontSize:17; bold:true; marginBottom:4px">'注册渠道转化漏斗分析'</h1>
<p style="color:#7A5040; fontSize:9">'报告编号:MKT-2024-Q4-025 | 生成日期:2025年1月10日 | 统计周期:2024年全年'</p>
</div>
FDF0EA 浅橙底、一圈 #E8CDBF 细边、左肩 6px 深橙粗线,标题用主色橙字压在浅底上。深底抬头的分量感强,适合"这是正式文件"的场合;浅底加粗线的抬头轻一级,营销分析报告用它不显官僚。左肩线给到 6px 比常见的 3px、4px 都粗——浅底卡片存在感弱,粗一点的肩线是它的视觉配重,我把肩线缩回 3px 试过一版,整块卡片像浮在页面上,压不住。元信息一行串了报告编号、生成日期、统计周期三段,编号 MKT-2024-Q4-025 里带了季度和 Demo 序号,归档检索方便,字色用 #7A5040 比标题淡两档,信息全但不抢标题。两种抬头我都保留过一版,最后业务方拍板浅底,理由是打印黑白稿时深底色块会变成一大块死黑。
选型四:分节标题,下划线还是色条
<h2 style="color:#BF360C; fontSize:13; bold:true; underline:true; marginBottom:8px">'一、各渠道新增注册漏斗'</h2>
三个分节标题全是 #BF360C 橙字加 underline:true 下划线。对照路线是浅色底条或左肩线那类带背景块的做法。下划线式最省纵向空间——没有底色的 padding,标题就是一行字加一条线;色条式自带呼吸感但要吃掉上下几像素。这份模板抬头已经有一块带边框的卡片,分节再用色条就重复了,下划线和"编号 + 日期"那种轻量气质更配。中间那节"二、渠道投放效果明细"的表格反而是全页最重的元素:表头 #BF360C 实底白字,合计行也整行实底反白——29,100 人、100.0%、35 元三个合计数是全报告的锚点,用整行实底把它顶出来。数据行的斑马纹垫 #FDF0EA,和抬头同色,整页橙系收得很拢。
选型五:四条数据的写法,Series 套 DataItem
数据装配是漏斗图特有的三段式:
.series(Collections.singletonList(
new Series()
.name("注册渠道")
.type("funnel")
.data(Arrays.asList(
new DataItem("广告投放", 12000),
new DataItem("搜索引擎", 8600),
new DataItem("渠道合作", 5400),
new DataItem("老客推荐", 3100)
))))
每个 DataItem 是名字加数值对,按数值从大到小排——漏斗的宽窄就是靠这个顺序成立的,把 3100 的老客推荐放到第一位,图会画出来但"漏斗"的隐喻就破了。Funnel 形状本体用 new Funnel().width(600).topY(80).bottomY(200).gap(2).borderColor(Color.GRAY) 配置:宽 600、上下边界和层间 2px 缝隙、灰色描边。JFunnelOption.createDefaultFunnel() 起手再链式覆盖,title、funnel、series、colors 四段一气呵成,最后 option.setFunnelOption(funnelOption) 挂载。明细表里四渠道的占比 41.2% / 29.6% / 18.6% / 10.6% 与单客获取成本 46 / 32 / 28 / 12 元,是策略建议(预算 10% 迁向老客推荐、占比目标提到 15%)的数据底座——漏斗管量,表格管量价结合,这也是配色克制版表格敢用实底反白的原因。
页尾也是一份 flex 双栏以外的三栏样本:<lineSeparator style="strokeColor:#DCE3EC"> 压一条细线,下面 display:flex; justifyContent:space-between 摊三个定宽 div——左 180px"密级:内部"、中 200px 居中"生成时间:2025年1月10日"(带 opacity:0.8 淡一档)、右 180px 右对齐"编制:用户增长部"。我第一版把三行小字竖排堆在左下角,业务方说盖章页的落款习惯是"密级在左、时间居中、编制在右",flex 三栏一行摆平,还顺手演示了 textAlignment:right 在定宽容器里的用法。
"三、投放策略建议"用 listStyleType:disc 圆点列表装四条:结构结论(广告投放加搜索引擎合计贡献 70.8% 新增注册)、成本结论(老客推荐 12 元/人,不足广告投放 46 元的三分之一)、渠道合作的量价均衡判断(5,400 人、28 元/人)、以及动作建议——广告预算约 10% 迁向老客推荐活动,把推荐渠道占比从 10.6% 提到 15%。四条从结构到成本到动作,和前两节的漏斗、明细表一一咬合,节标题的下划线样式在这种"短段落建议"场景里也够用了。
复现清单
- 依赖
io.github.paohaijiao:jquick-pdfx:4.7.0+(Apache-2.0 协议); JFunnelOption.createDefaultFunnel()起手,链式配 title / funnel(width、topY、bottomY、gap、borderColor)/ series / colors;DataItem按数值降序排列,option.setFunnelOption()挂载,JChartType.Funnel渲染;- 四层配色取主色同色系低饱和渐变;
JPdfConfig开setFlexLayout(true),双栏版式的display:flex才生效;- 缩图 285px 配右侧读法栏,抬头浅底加 6px 左肩线;
- 输出验证
D:\test\biz\25_channel_funnel.pdf。
完整源码附录
/*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright (c) [2025-2099] Martin (goudingcheng@gmail.com)
*/
package com.github.paohaijiao.biz.chart;
import com.github.paohaijiao.JOption;
import com.github.paohaijiao.config.JPdfConfig;
import com.github.paohaijiao.demo.constant.JQuickConstant;
import com.github.paohaijiao.enums.JChartType;
import com.github.paohaijiao.executor.JQuickPdfFactory;
import com.github.paohaijiao.factory.JChartRendererFactory;
import com.github.paohaijiao.funnel.*;
import org.junit.Test;
import java.awt.Color;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;
/**
* 业务场景 Demo 25:渠道来源漏斗转化(信用平台 / 用户增长)
*
* <p>业务场景:信用平台统计广告投放、搜索引擎、渠道合作、老客推荐四类注册渠道的新增注册量,
* 以漏斗形态对比各渠道获客贡献,用于投放预算分配,主色采用暖调深橙 #BF360C。</p>
* <p>实际图表类型:{@link JChartType#Funnel} 漏斗图(展示各渠道新增注册量的递减分布)。</p>
*
* <p>模板:{@code report/biz/25_channel_funnel.txt};图表以 SVG 文本形式绑定到模板的
* {@code ${svg}} 占位符,输出到 {@code D:\test\biz\25_channel_funnel.pdf}。</p>
*
* <p>图表尺寸说明:图表按 700pt × 400pt(宽 × 高)的横版比例设计;模板中 {@code <svg>}
* 只声明宽度、不声明高度,因此宽度被页面自动收窄时高度会按原比例同步缩放,不会纵向拉伸变形。</p>
*
* @author Martin
* @version 1.0.0
*/
public class JQuickBiz25ChannelFunnelTest {
public static final String path = JQuickConstant.path;
@Test
public void biz25ChannelFunnel() throws IOException {
JFunnelOption funnelOption = JFunnelOption.createDefaultFunnel();
funnelOption = funnelOption
.title(new Title().text("注册渠道转化漏斗").subtext("2024年信用平台新增注册用户(单位:人)"))
.funnel(new Funnel()
.width(600)
.topY(80)
.bottomY(200)
.gap(2)
.borderColor(Color.GRAY)
).series(Collections.singletonList(
new Series()
.name("注册渠道")
.type("funnel")
.data(Arrays.asList(
new DataItem("广告投放", 12000),
new DataItem("搜索引擎", 8600),
new DataItem("渠道合作", 5400),
new DataItem("老客推荐", 3100)
))))
// 与主色 #BF360C 同色系的低饱和棕色渐变,避免高饱和跳色
.colors(
new Color(140, 62, 44),
new Color(166, 84, 58),
new Color(191, 108, 82),
new Color(214, 141, 117)
);
JOption option = new JOption();
option.setFunnelOption(funnelOption);
String svg = JChartRendererFactory.renderChart(JChartType.Funnel, option);
File dir = new File(path + "biz");
if (!dir.exists()) {
dir.mkdirs();
}
FileOutputStream fileOutputStream = new FileOutputStream(path + "biz/25_channel_funnel.pdf");
JPdfConfig config = new JPdfConfig();
// 开启 flex 行布局,使模板中的 display:flex 生效(图表居中)
config.getLayoutConfig().setFlexLayout(true);
JQuickPdfFactory factory = new JQuickPdfFactory(config);
factory.bind("svg", svg);
byte[] bytes = factory.executeResource("report/biz/25_channel_funnel.txt");
fileOutputStream.write(bytes);
fileOutputStream.close();
}
}
<pdf>
<body>
<div style="background:#FDF0EA; border:1px solid #E8CDBF; borderLeft:6px solid #BF360C; borderRadius:4px; padding:12px; marginBottom:12px; keepTogether:true">
<h1 style="color:#BF360C; fontSize:17; bold:true; marginBottom:4px">'注册渠道转化漏斗分析'</h1>
<p style="color:#7A5040; fontSize:9">'报告编号:MKT-2024-Q4-025 | 生成日期:2025年1月10日 | 统计周期:2024年全年'</p>
</div>
<div style="marginBottom:12px">
<h2 style="color:#BF360C; fontSize:13; bold:true; underline:true; marginBottom:8px">'一、各渠道新增注册漏斗'</h2>
<div style="display:flex; justifyContent:space-between; marginBottom:10px">
<div style="width:285px">
<div style="display:flex; justifyContent:center">
<svg style="width:285px">${svg}</svg>
</div>
</div>
<div style="width:265px">
<h3 style="color:#BF360C; fontSize:12; bold:true; marginBottom:6px">'漏斗读法'</h3>
<list style="listStyleType:disc; paddingLeft:14px; fontSize:9">
<li style="marginBottom:5px">'自上而下为四类注册渠道,条越长代表新增注册量越大。'</li>
<li style="marginBottom:5px">'广告投放为第一大来源,贡献约四成新增注册。'</li>
<li style="marginBottom:5px">'老客推荐量最小,但单客获取成本最低。'</li>
<li style="marginBottom:5px">'渠道合作居中,性价比介于两者之间。'</li>
</list>
</div>
</div>
<p style="fontSize:9; color:#6c757d; italic:true; marginTop:6px">'图 1 2024年信用平台新增注册用户渠道漏斗(单位:人;数据来源:用户增长看板)'</p>
</div>
<div style="marginBottom:12px">
<h2 style="color:#BF360C; fontSize:13; bold:true; underline:true; marginBottom:8px">'二、渠道投放效果明细'</h2>
<table style="width:540px; fontSize:10">
<tr>
<th style="backgroundColor:#BF360C; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'注册渠道'</th>
<th style="backgroundColor:#BF360C; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'新增注册(人)'</th>
<th style="backgroundColor:#BF360C; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'占比'</th>
<th style="backgroundColor:#BF360C; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'单客获取成本(元)'</th>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'广告投放'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'12,000'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'41.2%'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'46'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'搜索引擎'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'8,600'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'29.6%'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'32'</td>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'渠道合作'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'5,400'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'18.6%'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'28'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'老客推荐'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'3,100'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'10.6%'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#FDF0EA; border:1px solid #DCE3EC">'12'</td>
</tr>
<tr>
<td style="padding:6px; backgroundColor:#BF360C; color:white; bold:true; border:1px solid #BF360C">'合计'</td>
<td style="padding:6px; textAlign:right; backgroundColor:#BF360C; color:white; bold:true; border:1px solid #BF360C">'29,100'</td>
<td style="padding:6px; textAlign:right; backgroundColor:#BF360C; color:white; bold:true; border:1px solid #BF360C">'100.0%'</td>
<td style="padding:6px; textAlign:right; backgroundColor:#BF360C; color:white; bold:true; border:1px solid #BF360C">'35'</td>
</tr>
</table>
</div>
<div style="marginBottom:10px">
<h2 style="color:#BF360C; fontSize:13; bold:true; underline:true; marginBottom:8px">'三、投放策略建议'</h2>
<list style="listStyleType:disc; paddingLeft:16px; fontSize:10">
<li style="marginBottom:6px">'结构结论:广告投放 12,000 人、搜索引擎 8,600 人,两者合计贡献 70.8% 的新增注册,是获客主渠道。'</li>
<li style="marginBottom:6px">'成本结论:老客推荐单客获取成本仅 12 元,不足广告投放(46 元)的三分之一,投入产出效率最高。'</li>
<li style="marginBottom:6px">'渠道合作 5,400 人、成本 28 元/人,处于量价均衡区间,可继续扩大合作方名单。'</li>
<li style="marginBottom:6px">'建议:将广告预算中约 10% 向老客推荐活动迁移,目标把推荐渠道占比由 10.6% 提升至 15%。'</li>
</list>
</div>
<lineSeparator style="strokeColor:#DCE3EC"></lineSeparator>
<div style="display:flex; justifyContent:space-between; marginTop:8px">
<div style="width:180px">
<p style="color:#6c757d; fontSize:8">'密级:内部'</p>
</div>
<div style="width:200px; textAlignment:center">
<p style="color:#6c757d; fontSize:8; opacity:0.8">'生成时间:2025年1月10日'</p>
</div>
<div style="width:180px; textAlignment:right">
<p style="color:#6c757d; fontSize:8">'编制:用户增长部'</p>
</div>
</div>
</body>
</pdf>