Building an Area Chart for Credit Coverage Trends

Building an Area Chart for Credit Coverage Trends

official demo：

• FORMULAS 示例页：https://www.jquick.org/jquick-pdf/
• github 地址：https://github.com/paohaijiao/jquick-pdf

jquick-pdf by example — demo #3 of 184. Every article in this series ships one complete, runnable demo: a template file and a Java class. No snippets, no omissions.

An area chart makes cumulative coverage readable — the filled band shows how much of the portfolio is scored.

This document belongs to the Credit report — chart series set. Like every demo in the series it has its own colour scheme and layout combination, derived deterministically from the demo number — so the look is stable across runs and two neighbouring documents never look alike.

What you'll build

• A PDF written to 03_area.pdf
• A template file (report/credit_report_03_area.txt) with 1 bound placeholder
• A detail grid of 6 rows × 6 columns, laid out with width:100% so it fills the text area
• One self-contained Java class (JQuickCreditReport03AreaTest) that binds the data and renders the file

Bound placeholders

${svg}

Prerequisites

Java 8+ and one dependency — jquick-pdf is built on Apache PDFBox, not iText:

<dependency>
    <groupId>io.github.paohaijiao</groupId>
    <artifactId>jquick-pdfx</artifactId>
    <version>4.2.0</version>
</dependency>

Coordinates: io.github.paohaijiao:jquick-pdfx:4.2.0.

Step 1 — the template file

JPdfX is jquick-pdf's HTML-like template language. It lives in its own file (src/test/resources/report/credit_report_03_area.txt) instead of a Java string, so designers can edit it without touching code.

<pdf>
<body>
  <div style="background:linear-gradient(135deg, #283593 0%, #5C6BC0 100%); borderRadius:8px; paddings:18px; marginBottom:18px">
    <div style="display:flex; justifyContent:space-between; alignItems:center">
      <div style="width:430px">
        <h1 style="textAlignment:left; color:white; fontSize:20; margin:0">'企业信用评级报告'</h1>
        <p style="textAlignment:left; color:rgba(255,255,255,0.9); fontSize:11; marginTop:6px; marginBottom:0">'评估机构: 四川省企业信用评估中心'</p>
      </div>
      <div style="width:90px; height:90px; backgroundColor:rgba(255,255,255,0.15); borderRadius:8px; textAlignment:center; verticalAlignment:center">
        <p style="textAlignment:center; color:white; fontSize:26; bold:true; margin:0">'AAA'</p>
        <p style="textAlignment:center; color:white; fontSize:9; margin:0">'信用等级'</p>
      </div>
    </div>
    <p style="textAlignment:left; color:rgba(255,255,255,0.9); fontSize:10; marginTop:10px; marginBottom:0">'报告编号: CR-2023-08975 | 评估日期: 2023年11月15日'</p>
  </div>

  <div style="marginBottom:18px">
    <h2 style="color:#283593; fontSize:13; marginBottom:8px">'企业信息'</h2>
    <div style="display:flex; flexWrap:wrap">
      <div style="width:300px; margin:4px; padding:10px; border:1px solid #c5cae9; borderRadius:6px">
        <p style="fontSize:9; color:#3F51B5; margin:0">'统一信用代码'</p>
        <p style="fontSize:12; marginTop:3px; marginBottom:0">'91110108MA01XX1234'</p>
      </div>
      <div style="width:300px; margin:4px; padding:10px; border:1px solid #c5cae9; borderRadius:6px">
        <p style="fontSize:9; color:#3F51B5; margin:0">'成立日期'</p>
        <p style="fontSize:12; marginTop:3px; marginBottom:0">'2018年5月20日'</p>
      </div>
      <div style="width:300px; margin:4px; padding:10px; border:1px solid #c5cae9; borderRadius:6px">
        <p style="fontSize:9; color:#3F51B5; margin:0">'注册资本'</p>
        <p style="fontSize:12; marginTop:3px; marginBottom:0">'1000万元人民币'</p>
      </div>
      <div style="width:300px; margin:4px; padding:10px; border:1px solid #c5cae9; borderRadius:6px">
        <p style="fontSize:9; color:#3F51B5; margin:0">'法定代表人'</p>
        <p style="fontSize:12; marginTop:3px; marginBottom:0">'泡海椒'</p>
      </div>
      <div style="width:300px; margin:4px; padding:10px; border:1px solid #c5cae9; borderRadius:6px">
        <p style="fontSize:9; color:#3F51B5; margin:0">'所属行业'</p>
        <p style="fontSize:12; marginTop:3px; marginBottom:0">'软件和信息技术服务业'</p>
      </div>
      <div style="width:300px; margin:4px; padding:10px; border:1px solid #c5cae9; borderRadius:6px">
        <p style="fontSize:9; color:#3F51B5; margin:0">'企业规模'</p>
        <p style="fontSize:12; marginTop:3px; marginBottom:0">'中型（150-200人）'</p>
      </div>
    </div>
  </div>

  <div style="marginBottom:18px">
    <h2 style="color:#283593; borderBottom:2px solid #3F51B5; paddingBottom:4px; fontSize:13; marginBottom:10px">'历年财务数据（单位：万元）'</h2>
    <table style="width:620px; fontSize:10; marginTop:8px">
      <tr>
        <th style="backgroundColor:#3F51B5; color:white; borderBottom:1px solid #e8eaf6; padding:6px; textAlign:left">'财务指标'</th>
        <th style="backgroundColor:#3F51B5; color:white; borderBottom:1px solid #e8eaf6; padding:6px; textAlign:right">'2020年'</th>
        <th style="backgroundColor:#3F51B5; color:white; borderBottom:1px solid #e8eaf6; padding:6px; textAlign:right">'2021年'</th>
        <th style="backgroundColor:#3F51B5; color:white; borderBottom:1px solid #e8eaf6; padding:6px; textAlign:right">'2022年'</th>
        <th style="backgroundColor:#3F51B5; color:white; borderBottom:1px solid #e8eaf6; padding:6px; textAlign:right">'2023年'</th>
        <th style="backgroundColor:#3F51B5; color:white; borderBottom:1px solid #e8eaf6; padding:6px; textAlign:right">'增长率'</th>
      </tr>
      <tr>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:left; borderBottom:1px solid #e8eaf6; bold:true">'营业收入'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'8,560'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'12,340'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'18,920'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'25,680'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6; color:#3F51B5; bold:true">'+44.2%'</td>
      </tr>
      <tr>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:left; borderBottom:1px solid #e8eaf6; bold:true">'净利润'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'1,240'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'2,150'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'3,890'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'5,420'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6; color:#3F51B5; bold:true">'+63.8%'</td>
      </tr>
      <tr>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:left; borderBottom:1px solid #e8eaf6; bold:true">'总资产'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'15,800'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'22,450'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'31,200'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'42,800'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6; color:#3F51B5; bold:true">'+39.5%'</td>
      </tr>
      <tr>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:left; borderBottom:1px solid #e8eaf6; bold:true">'净资产'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'9,200'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'13,800'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'19,500'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'26,400'</td>
        <td style="backgroundColor:#f5f6fb; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6; color:#3F51B5; bold:true">'+42.1%'</td>
      </tr>
      <tr>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:left; borderBottom:1px solid #e8eaf6; bold:true">'毛利率'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'42.5%'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'45.8%'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'48.2%'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6">'51.6%'</td>
        <td style="backgroundColor:#ffffff; padding:6px; textAlign:right; borderBottom:1px solid #e8eaf6; color:#3F51B5; bold:true">'+9.1%'</td>
      </tr>
    </table>
  </div>

  <div style="marginBottom:18px">
    <h2 style="color:#283593; borderBottom:2px solid #3F51B5; paddingBottom:4px; fontSize:13; marginBottom:10px">'关键经营指标'</h2>
    <div style="display:flex; flexWrap:wrap">
      <div style="width:290px; margin:4px; padding:10px; border:1px solid #5C6BC0; borderRadius:6px">
        <p style="fontSize:11; bold:true; color:#283593; margin:0">'营收增长率'</p>
        <p style="fontSize:10; marginTop:3px; marginBottom:0">'连续三年保持40%以上增长，2023年达到25,680万元'</p>
      </div>
      <div style="width:290px; margin:4px; padding:10px; border:1px solid #5C6BC0; borderRadius:6px">
        <p style="fontSize:11; bold:true; color:#283593; margin:0">'利润率提升'</p>
        <p style="fontSize:10; marginTop:3px; marginBottom:0">'净利率从14.5%提升至21.1%，盈利能力显著增强'</p>
      </div>
      <div style="width:290px; margin:4px; padding:10px; border:1px solid #5C6BC0; borderRadius:6px">
        <p style="fontSize:11; bold:true; color:#283593; margin:0">'研发投入'</p>
        <p style="fontSize:10; marginTop:3px; marginBottom:0">'研发费用年均增长38.9%，占营收比例达13.3%'</p>
      </div>
      <div style="width:290px; margin:4px; padding:10px; border:1px solid #5C6BC0; borderRadius:6px">
        <p style="fontSize:11; bold:true; color:#283593; margin:0">'人才结构'</p>
        <p style="fontSize:10; marginTop:3px; marginBottom:0">'技术研发人员占比42%，硕士以上学历占35%'</p>
      </div>
      <div style="width:290px; margin:4px; padding:10px; border:1px solid #5C6BC0; borderRadius:6px">
        <p style="fontSize:11; bold:true; color:#283593; margin:0">'客户质量'</p>
        <p style="fontSize:10; marginTop:3px; marginBottom:0">'服务15家上市公司，客户续约率92%，大客户满意度4.8/5.0'</p>
      </div>
      <div style="width:290px; margin:4px; padding:10px; border:1px solid #5C6BC0; borderRadius:6px">
        <p style="fontSize:11; bold:true; color:#283593; margin:0">'资产质量'</p>
        <p style="fontSize:10; marginTop:3px; marginBottom:0">'资产负债率维持在38%左右，流动比率2.8，偿债能力良好'</p>
      </div>
    </div>
  </div>

  <div style="marginBottom:18px">
    <h2 style="color:#283593; borderBottom:2px solid #3F51B5; paddingBottom:4px; fontSize:13; marginBottom:10px">'信用评级趋势区域图'</h2>
    <div style="display:flex; justifyContent:center">
      <svg style="width:440px;height:400px">${svg}</svg>
    </div>
    <div style="display:flex; justifyContent:space-around; marginTop:10px">
      <p style="width:150px; fontSize:10; color:#3F51B5; margin:0">'财务状况(90分): 营收稳定增长'</p>
      <p style="width:150px; fontSize:10; color:#3F51B5; margin:0">'经营能力(95分): 客户留存率高'</p>
      <p style="width:150px; fontSize:10; color:#3F51B5; margin:0">'偿债能力(85分): 负债率合理'</p>
      <p style="width:150px; fontSize:10; color:#3F51B5; margin:0">'发展潜力(92分): 研发投入增加'</p>
    </div>
  </div>

  <div style="marginBottom:18px">
    <h2 style="color:#283593; fontSize:13; marginBottom:10px">'综合评价'</h2>
    <div style="display:flex; justifyContent:space-between">
      <div style="width:300px; padding:12px; backgroundColor:#e8eaf6; borderRadius:6px">
        <p style="fontSize:12; bold:true; color:#283593; margin:0">'优势'</p>
        <p style="fontSize:10; marginTop:6px; marginBottom:0">'作为国家级高新技术企业和专精特新"小巨人"企业，在云计算和大数据领域表现出色；财务状况健康，经营能力突出，技术创新能力强，具备良好的发展潜力。'</p>
      </div>
      <div style="width:300px; padding:12px; backgroundColor:#fff8e1; borderRadius:6px">
        <p style="fontSize:12; bold:true; color:#283593; margin:0">'关注事项'</p>
        <p style="fontSize:10; marginTop:6px; marginBottom:0">'信用评级为AAA级，展望稳定；建议持续关注行业竞争加剧及研发投入的产出效率。'</p>
      </div>
    </div>
  </div>

  <div style="height:1px; backgroundColor:#e8eaf6; marginTop:12px"></div>
  <div style="textAlignment:center; paddingTop:8px; paddingBottom:8px">
    <p style="fontSize:9; color:#7986cb; margin:0">'本报告依据公开信息和专业评估模型生成，仅供参考 | 报告生成时间: 2025年09月06日'</p>
    <p style="fontSize:9; color:#7986cb; margin:0">'© 2023 企业信用评估中心 版权所有 | 认证编号: CE-2023-001'</p>
  </div>
  <div style="height:1px; backgroundColor:#e8eaf6"></div>
</body>
</pdf>

Step 2 — the Java class

jquick-pdfx/src/test/java/com/github/paohaijiao/biz/report/JQuickCreditReport03AreaTest.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 ([e-mail])
 */
package com.github.paohaijiao.biz.report;

import com.github.paohaijiao.JOption;
import com.github.paohaijiao.combol.area.JAreaChartData;
import com.github.paohaijiao.combol.area.JSeriesData;
import com.github.paohaijiao.combol.area.JTheme;
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;

/**
 * 统一信用报告 —— 风格 03：区域图（靛蓝）
 *
 * <p>以 {@code report/credit_report_03_area.txt} 为模板，把区域图渲染成 SVG 后
 * 绑定到模板中的 {@code ${svg}} 占位符，输出到 {@code D:\test\creditreport\03_area.pdf}。</p>
 *
 * @author Martin
 * @version 1.0.0
 */
public class JQuickCreditReport03AreaTest {

    public static final String path = JQuickConstant.path;

    @Test
    public void report03Area() throws IOException {
        JAreaChartData data = new JAreaChartData();
        data.setTitle("信用评级趋势");
        data.setSubtitle("2020-2023年度（单位：万元）");
        data.setXAxisTitle("年度");
        data.setYAxisTitle("金额（万元）");
        data.setLegendText("营业收入");
        data.setShowDataLabels(true);
        data.setSeriesList(Arrays.asList(new JSeriesData("营业收入", Arrays.asList(8560.0, 12340.0, 18920.0, 25680.0))));
        data.setXAxisLabels(Arrays.asList("2020年", "2021年", "2022年", "2023年"));
        data.setTheme(JTheme.DEFAULT);
        JOption option = new JOption();
        option.setData(data);

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

        File dir = new File(path + "creditreport");
        if (!dir.exists()) {
            dir.mkdirs();
        }
        FileOutputStream fileOutputStream = new FileOutputStream(path + "creditreport/03_area.pdf");
        JPdfConfig config = new JPdfConfig();
        // 开启 flex 行布局：图表与其右侧的指标说明面板在宽度允许时并排，而不是换行堆叠。
        config.getLayoutConfig().setFlexLayout(true);
        JQuickPdfFactory factory = new JQuickPdfFactory(config);
        factory.bind("svg", svg);
        byte[] bytes = factory.executeResource("report/credit_report_03_area.txt");
        fileOutputStream.write(bytes);
        fileOutputStream.close();
    }
}

Step 3 — run it

The class is a JUnit test, so run it with Maven:

mvn -pl jquick-pdfx test -Dtest=JQuickCreditReport03AreaTest

…or call the test method from a main wrapper if you want a plain entry point:

public static void main(String[] args) throws Exception {
    new JQuickCreditReport03AreaTest().report03Area();
}

Output: D:/test/creditreport/03_area.pdf

How it works

Binding a chart SVG into the template

The chart is not a bitmap — JChartRendererFactory.renderChart(...) returns an SVG string, and the template embeds it with a single <svg> element bound to ${svg}. That means the chart stays vector-sharp at any zoom level, and it participates in normal flow layout instead of being stamped on top of the page.

• Declare only the width on <svg>; the height is derived from the chart's aspect ratio, so the chart never stretches vertically.
• Open config.getLayoutConfig().setFlexLayout(true) if the template centers the chart with display:flex.
• Bind the SVG string with factory.bind("svg", svg) — bind() is pure data injection and never re-parses markup.

String svg = JChartRendererFactory.renderChart(JChartType.LINE, option);
JQuickPdfFactory factory = new JQuickPdfFactory(config);
factory.bind("svg", svg);
byte[] bytes = factory.executeResource(TEMPLATE);

Flex layout: what it does and does not do

display:flex is opt-in: without config.getLayoutConfig().setFlexLayout(true) the children stack vertically. Even with it enabled, children whose fixed widths sum beyond the text area wrap to the next line — so a two-column layout must budget its pixels.

• Enable flex on JPdfConfig before creating the factory.
• Use fixed px widths that sum to less than the text width (~483px on A4 with 40pt margins).
• Nested div two-column layouts are unreliable here — a full-width single column is safer.

JPdfConfig config = new JPdfConfig();
config.getLayoutConfig().setFlexLayout(true);

Template syntax cheat sheet

Syntax	Meaning
<areaBreak></areaBreak>	Force the next block onto a fresh page (CSS page-break is not supported).
<image src='D:/.../x.png'>	Embed an image. src is a raw path — it is not evaluated as an expression.
<svg style="width:479pt">${svg}</svg>	Embed a vector chart produced by JChartRendererFactory.
// comment	Line comment. Keep <!-- ... --> comments short — long ones can blank the render.
<p style="fontSize:9pt; bold:true">	Inline styles use camelCase keys, CSS-like values.

Gotchas worth remembering

• A <td> holds text only — nested <p>, <image> or <table> is dropped.
• There is no colspan; emit one <td> per column and use '—' as filler.
• setFontSize takes a float (8.5f); setMargins takes List<Integer>.
• The footer format accepts exactly one %d.

Output

Wrap up

You now have a template file, a Java class and a PDF — all three reproducible from a clean clone. Swap the placeholder blocks for real data (or for real seal images) and the layout does not move.

Series navigation: ← #2 Plotting a Four-Year Credit Trend Line Chart in a PDF Report　·　#4 Pie Chart: Breaking Down the Credit Rating Composition →

Full index: README.md　·　Source: jquick-pdf

---

Appendix — files in this demo

Role	Path
Java class	jquick-pdfx/src/test/java/com/github/paohaijiao/biz/report/JQuickCreditReport03AreaTest.java
Template	jquick-pdfx/src/test/resources/report/credit_report_03_area.txt
Output PDF	03_area.pdf
Preview image	images/03.png