jquick-pdf echart风格预算执行进度报表模板:市财政局汇报页的一条条追问与回答

jquick-pdf 生成年度预算执行进度 PDF:横向条形图画预算执行率的评审问答实录

摘要(meta description):市财政局五部门预算执行进度汇报,jquick-pdf 4.7.0+(Apache-2.0 协议)用横向条形图"预算下达 vs 已执行"双系列替代进度条。本文模拟评审会连环追问组织全文:进度图去哪了、为什么不画百分比、数据标签挤不挤、虚线分隔怎么画,每节回答一个追问,附完整 Java 源码与模板。

标签 :jquick-pdf、Java PDF、报表开发、预算执行

官网示例:

真实渲染效果预览

以下为上述代码 + 模板真实运行生成的 PDF 首屏预览(由 jquick-pdf 渲染输出,非示意图):

评审会上被问住的地方

这份 JQuickBiz24BudgetProgressTest 我调完模板拿去给业务处室预审,原以为是走个流程,结果被追问了一下午。追问不一定都有标准答案,但每一个都逼我把配置里的某个决定想清楚。把问答整理成文,输出路径 D:\test\biz\24_budget_progress.pdf,主题政务深蓝 #1F4E79。(效果预览图 alt:jquick-pdf 年度预算执行进度 PDF,深蓝主题,五部门预算下达与已执行横向条形图居中,执行率明细表与进度分析铺底)

追问一:要的是进度图,怎么变成两根条形了?

这是评审的第一问,也是我准备最充分的一问。jquick-pdf 暂无进度图(进度条)渲染器,Demo 的 Javadoc 原话是:用「预算下达 vs 已执行」两条横向条形并列的方式替代进度图,执行率由两段条形的长度对比直观呈现。替代逻辑成立------执行率本来就是两个量的比值,进度条画的是比值本身,双条形画的是比值的两端,长度差就是执行率。汇报的效果甚至更好:领导看双条形能同时看到绝对规模(教育局 12800 万下 11260 万)和相对进度,进度条只剩后者。

java 复制代码
List<Double> budget = Arrays.asList(12800.0, 9600.0, 8400.0, 6200.0, 5100.0);
List<Double> executed = Arrays.asList(11260.0, 8120.0, 6930.0, 5480.0, 4320.0);
chartData.addBarData(new JHorizontalBarChartData.BarData("预算下达", budget, JHorizontalBarChartData.COLOR_A));
chartData.addBarData(new JHorizontalBarChartData.BarData("已执行", executed, JHorizontalBarChartData.COLOR_B));

两个系列的颜色直接用数据类自带的 COLOR_A、COLOR_B 常量,没有另配。源码注释里写了句"颜色沿用政务系统低饱和主色",这两个常量的低饱和风格和模板 #1F4E79 的政务蓝确实压得住场面,我试过自己换成高饱和红绿对比,图一下子变得像促销海报,改回来了。

追问二:执行率为什么不直接画在图上?

评审的第二问。图表用 setValueWithPercent(false) 明确关掉了百分比模式------条形长度按金额绝对值走,横轴是"金额(万元)"。我的回答是分工:图负责规模对比,执行率的精确数值放"二、分部门预算执行明细"表里。表里教育局 87.97%、卫健委 84.58%、交通局 82.50%、农业农村局 88.39%、民政局 84.71%,合计行 85.77%,这些两位小数画在条形上要么挤成一团要么四舍五入失真,放进表格右对齐一列才是它该待的地方。评审接受了这个说法,补了一句要求:表格里执行率旁的进度评价要用颜色区分------于是"进度达标""正常推进""进度领先"用 #1B5E20 绿色加粗,交通局的"预警关注"用 #BF360C 橙红加粗,五个部门扫一眼就知道谁出问题。

追问三:五个部门十条柱,数据标签开了不挤吗?

java 复制代码
chartData.setShowDataLabels(true);
chartData.setValueWithPercent(false);

setShowDataLabels(true) 开启条形端点的数值标签,十个数标在图上。实际渲染不挤,原因是横向条形的标签在条形末端外侧,条形之间纵向留白足够。我做过对比:关掉标签后图变干净了,但"预算下达 12800、已执行 11260"这种关键数值全靠对横轴刻度估读,评审当场表示要数值。这组配置的最后一块是轴标题,setXAxisTitle("金额(万元)") 和 setYAxisTitle("部门"),加上图表自己的标题副标题:

java 复制代码
chartData.setTitleText("2024年度各部门预算执行进度");
chartData.setSubtitleText("预算下达额与已执行额对比(截至2024年9月30日)");

注意这组是 JHorizontalBarChartData 自带的标题体系,渲染进 SVG 里,模板抬头那句"预算下达额与已执行额对比(截至2024年9月30日,单位:万元)"是另一份文案------图内图外各说各的,我一度以为是重复配置,删掉 SVG 里的标题后图变成无头图,才知道这套数据类的标题是画进图里的。

追问四:Y 轴的部门顺序为什么不是表里的顺序?

java 复制代码
chartData.addYAxisLabel("教育局");
chartData.addYAxisLabel("卫健委");
chartData.addYAxisLabel("交通局");
chartData.addYAxisLabel("农业农村局");
chartData.addYAxisLabel("民政局");

addYAxisLabel 按调用顺序从上往下(或从下往上,看渲染方向)铺部门,数值列表 budget、executed 的下标和它一一对应:12800 是教育局、9600 是卫健委。我答"表里什么顺序图里就什么顺序"时被追问"那为什么不按执行率排序",老实承认是沿用了预算下达额的报送顺序------政务报告里部门排序有惯例,不能自作主张按数据重排。这就是 addYAxisLabel 一个个加而不是传数组的好处:顺序改动只动五行调用,不用去数数组元素。

追问五:分析区每条上面的虚线是什么?

"三、进度分析与下半年建议"的四条分析,每条顶上都有一道虚线:

html 复制代码
<li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">
  '总体进度:五个部门预算下达合计 42,100 万元,已执行 36,110 万元,整体执行率 85.77%,略高于序时进度。'
</li>

borderTop:1px dashed #C7C7C7 加 paddingTop:6px,虚线悬在文字上方当分隔,比实线轻、比纯留白清楚。评审问"为什么不用圆点列表",答:这四条是并列结论不是枚举项,虚线分隔的段落感更适合"总体进度 / 领先部门 / 预警部门 / 下半年建议"这种带小标题的长句。四条内容我顺带讲了一遍:领先的是农业农村局 88.39% 和教育局 87.97%,预警的交通局 82.50% 低于整体 3.27 个百分点、原因挂在工程招标进度滞后上,建议部分给交通局上项目清单周调度、同时提醒执行率超 87% 的部门防年末突击支出。

追问六:页尾那条水平线是谁画的?

html 复制代码
<lineSeparator style="strokeColor:#DCE3EC"></lineSeparator>
<p style="color:#6c757d; fontSize:8; marginTop:8px">'数据来源:市财政局预算管理一体化系统 | 生成时间:2025年10月8日 | 密级:内部'</p>

不是 div 的 borderTop,是模板引擎自己的 <lineSeparator> 元素,strokeColor:#DCE3EC 控制线条颜色。我最初用空 div 画线,评审问"这条线为什么和上面小字的间距这么大",div 的 margin 折叠行为和 lineSeparator 不一样。数据来源、生成时间、密级三段用竖线串成一行 8 号灰字,压在页尾。

分节标题的样式评审也点过名:每节标题外套一层 backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px 的浅蓝底色条,标题文字 #1F4E79 加粗------三节统一,和表格表头同色系,页面骨架清晰。明细表整体 540px 宽、10 号字,表头 #1F4E79 实底,数据行的隔行垫色正是这套 #E8F0F7,和节标题色条同源;合计行整行垫色加粗,42,100、36,110、85.77% 三个合计数压在页表底部,评审核对总数时第一眼就落在那儿。

抬头是 background:#1F4E79 的居中卡片:18 号白字大标题,下面两行 10 号说明------"预算下达额与已执行额对比(截至2024年9月30日,单位:万元)"白字,"编制单位:市财政局预算管理科 | 报送对象:市政府常务会议"用 #CFE0EF 淡一档。卡片套 keepTogether:true 防分页拦腰切。政务报告抬头写报送对象这点值得保留,谁收这份文件、文件口径到哪天,抬头两行就说清了。图表区照例是 display:flex; justifyContent:center 的居中容器,svg 声明 width:700pt 不写高度,宽度被收窄时等比缩放;图下 9 号斜体图注"图 1 五个业务部门预算下达与已执行对比(数据来源:预算管理一体化系统)"把数据出处钉在图边。Java 侧照例一行 config.getLayoutConfig().setFlexLayout(true),源码注释写明是使模板中的 display:flex 生效(图表居中),那个居中容器全靠它。

复现清单

  1. 依赖 io.github.paohaijiao:jquick-pdfx:4.7.0+(Apache-2.0 协议);
  2. JHorizontalBarChartData 配标题、副标题、双轴标题,setValueWithPercent(false)、setShowDataLabels(true);
  3. addYAxisLabel 按报送顺序铺部门,两个系列 addBarData 挂 COLOR_A/COLOR_B;
  4. option.setData(chartData) 后 JChartRendererFactory.renderChart(JChartType.HorizontalBar, option) 出 SVG;
  5. JPdfConfig 开 setFlexLayout(true);
  6. 明细表执行率列配绿/橙评价色,分析区用 borderTop:1px dashed 虚线分隔,页尾用 <lineSeparator>;
  7. 输出验证 D:\test\biz\24_budget_progress.pdf。

完整源码附录

java 复制代码
/*
 * 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.combol.JHorizontalBarChartData;
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 org.junit.Test;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

/**
 * 业务场景 Demo 24:年度预算执行进度仪表盘(政务/企业财务)
 *
 * <p>业务场景:市财政局预算管理科跟踪各业务部门年度预算下达额与已执行额,用于市政府常务会议预算执行进度汇报。</p>
 * <p>实际图表类型:{@link JChartType#HorizontalBar} 横向条形图。jquick-pdf 暂无进度图(进度条)渲染器,
 * 因此用「预算下达 vs 已执行」两条横向条形并列的方式替代进度图,执行率由两段条形的长度对比直观呈现。</p>
 *
 * <p>模板:{@code report/biz/24_budget_progress.txt};图表以 SVG 文本形式绑定到模板的
 * {@code ${svg}} 占位符,输出到 {@code D:\test\biz\24_budget_progress.pdf}。</p>
 *
 * <p>图表尺寸说明:图表按 700pt 宽的横版比例设计;模板中 {@code <svg>} 只声明宽度、不声明高度,
 * 宽度被页面自动收窄时高度会按原比例同步缩放,不会纵向拉伸变形。</p>
 *
 * @author Martin
 * @version 1.0.0
 */
public class JQuickBiz24BudgetProgressTest {

    public static final String path = JQuickConstant.path;

    @Test
    public void biz24BudgetProgress() throws IOException {
        JHorizontalBarChartData chartData = new JHorizontalBarChartData();
        chartData.setTitleText("2024年度各部门预算执行进度");
        chartData.setSubtitleText("预算下达额与已执行额对比(截至2024年9月30日)");
        chartData.setXAxisTitle("金额(万元)");
        chartData.setYAxisTitle("部门");
        chartData.setValueWithPercent(false);
        chartData.setShowDataLabels(true);
        chartData.addYAxisLabel("教育局");
        chartData.addYAxisLabel("卫健委");
        chartData.addYAxisLabel("交通局");
        chartData.addYAxisLabel("农业农村局");
        chartData.addYAxisLabel("民政局");
        // 两条系列分别表示预算下达额与已执行额,颜色沿用政务系统低饱和主色
        List<Double> budget = Arrays.asList(12800.0, 9600.0, 8400.0, 6200.0, 5100.0);
        List<Double> executed = Arrays.asList(11260.0, 8120.0, 6930.0, 5480.0, 4320.0);
        chartData.addBarData(new JHorizontalBarChartData.BarData("预算下达", budget, JHorizontalBarChartData.COLOR_A));
        chartData.addBarData(new JHorizontalBarChartData.BarData("已执行", executed, JHorizontalBarChartData.COLOR_B));
        JOption option = new JOption();
        option.setData(chartData);

        String svg = JChartRendererFactory.renderChart(JChartType.HorizontalBar, option);

        File dir = new File(path + "biz");
        if (!dir.exists()) {
            dir.mkdirs();
        }
        FileOutputStream fileOutputStream = new FileOutputStream(path + "biz/24_budget_progress.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/24_budget_progress.txt");
        fileOutputStream.write(bytes);
        fileOutputStream.close();
    }
}
html 复制代码
<pdf>
<body>
  <div style="textAlignment:center; marginBottom:12px; padding:14px; background:#1F4E79; borderRadius:4px; keepTogether:true">
    <h1 style="textAlignment:center; color:white; marginBottom:6px; fontSize:18; bold:true">'2024年度各部门预算执行进度'</h1>
    <p style="textAlignment:center; color:white; fontSize:10; margin:2px">'预算下达额与已执行额对比(截至2024年9月30日,单位:万元)'</p>
    <p style="textAlignment:center; color:#CFE0EF; fontSize:10; margin:2px">'编制单位:市财政局预算管理科 | 报送对象:市政府常务会议'</p>
  </div>

  <div style="marginBottom:12px">
    <div style="backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px; marginBottom:8px">
      <h2 style="color:#1F4E79; fontSize:13; bold:true; marginTop:0; marginBottom:0">'一、各部门预算执行总体情况'</h2>
    </div>
    <div style="display:flex; justifyContent:center">
      <svg style="width:700pt">${svg}</svg>
    </div>
    <p style="fontSize:9; color:#6c757d; italic:true; marginTop:6px">'图 1  五个业务部门预算下达与已执行对比(数据来源:预算管理一体化系统)'</p>
  </div>

  <div style="marginBottom:12px">
    <div style="backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px; marginBottom:8px">
      <h2 style="color:#1F4E79; fontSize:13; bold:true; marginTop:0; marginBottom:0">'二、分部门预算执行明细'</h2>
    </div>
    <table style="width:540px; fontSize:10">
      <tr>
        <th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'部门'</th>
        <th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'预算下达(万元)'</th>
        <th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'已执行(万元)'</th>
        <th style="backgroundColor:#1F4E79; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'执行率'</th>
        <th style="backgroundColor:#1F4E79; 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,800'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'11,260'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'87.97%'</td>
        <td style="padding:5px; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'进度达标'</td>
      </tr>
      <tr>
        <td style="padding:5px; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'卫健委'</td>
        <td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'9,600'</td>
        <td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'8,120'</td>
        <td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'84.58%'</td>
        <td style="padding:5px; backgroundColor:#E8F0F7; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'正常推进'</td>
      </tr>
      <tr>
        <td style="padding:5px; border:1px solid #DCE3EC">'交通局'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'8,400'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'6,930'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'82.50%'</td>
        <td style="padding:5px; color:#BF360C; bold:true; border:1px solid #DCE3EC">'预警关注'</td>
      </tr>
      <tr>
        <td style="padding:5px; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'农业农村局'</td>
        <td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'6,200'</td>
        <td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'5,480'</td>
        <td style="padding:5px; textAlign:right; backgroundColor:#E8F0F7; border:1px solid #DCE3EC">'88.39%'</td>
        <td style="padding:5px; backgroundColor:#E8F0F7; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'进度领先'</td>
      </tr>
      <tr>
        <td style="padding:5px; border:1px solid #DCE3EC">'民政局'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'5,100'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'4,320'</td>
        <td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'84.71%'</td>
        <td style="padding:5px; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'正常推进'</td>
      </tr>
      <tr>
        <td style="padding:6px; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'合计'</td>
        <td style="padding:6px; textAlign:right; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'42,100'</td>
        <td style="padding:6px; textAlign:right; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'36,110'</td>
        <td style="padding:6px; textAlign:right; backgroundColor:#E8F0F7; bold:true; border:1px solid #DCE3EC">'85.77%'</td>
        <td style="padding:6px; backgroundColor:#E8F0F7; color:#1B5E20; bold:true; border:1px solid #DCE3EC">'总体达标'</td>
      </tr>
    </table>
  </div>

  <div style="marginBottom:10px">
    <div style="backgroundColor:#E8F0F7; padding:6px 10px; borderRadius:3px; marginBottom:8px">
      <h2 style="color:#1F4E79; fontSize:13; bold:true; marginTop:0; marginBottom:0">'三、进度分析与下半年建议'</h2>
    </div>
    <list style="list-style-type:none; padding-left:0; fontSize:10">
      <li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'总体进度:五个部门预算下达合计 42,100 万元,已执行 36,110 万元,整体执行率 85.77%,略高于序时进度。'</li>
      <li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'领先部门:农业农村局 88.39%、教育局 87.97% 执行率居前两位,项目开工早、资金支付节奏快。'</li>
      <li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'预警部门:交通局执行率 82.50% 为五部门最低,低于整体水平 3.27 个百分点,主要受工程招标进度滞后影响。'</li>
      <li style="borderTop:1px dashed #C7C7C7; paddingTop:6px; marginBottom:6px">'下半年建议:对交通局实行项目清单周调度;对执行率已超 87% 的部门,提示避免年末突击支出,确保资金使用合规。'</li>
    </list>
  </div>

  <lineSeparator style="strokeColor:#DCE3EC"></lineSeparator>
  <p style="color:#6c757d; fontSize:8; marginTop:8px">'数据来源:市财政局预算管理一体化系统 | 生成时间:2025年10月8日 | 密级:内部'</p>
</body>
</pdf>
相关推荐
利威尔xu1 小时前
Go channel 关闭 3 个 panic:向已关闭 channel 发送,服务当场崩溃
开发语言·后端·golang·并发编程·channel
Csvn2 小时前
Nginx 反向代理入门:proxy_pass 两种形态、超时链与 502/504 分辨
后端·nginx
LVZ2 小时前
AI Agent 缺的不是更强的模型,而是一个运行时
前端·javascript·后端
鶴哥只手遮天3 小时前
《VulkanSceneGraph 1.1.16 源码深度解析》第二章 内存工程:Allocator、MemoryBlock 与场景图的物理布局
后端
im_AMBER3 小时前
IO 多路复用:select、poll 和 epoll
后端·面试·架构
码农Kzx3 小时前
【开源】当桌面图标开始打台球:我用 WinForms 做了一桌“真的”台球
后端
鶴哥只手遮天3 小时前
《VulkanSceneGraph 1.1.16 源码深度解析》第五章 数据对象:从 `Data` 到 `VkBuffer`/`VkImage` 的完整链路
后端
xjz18423 小时前
Rust 比较运算符:不只是 `==` 和 `<`,那些新手必踩的坑
后端
清和明随想3 小时前
一文吃透生产者-消费者模型:wait/notify 等待唤醒机制详解
后端