freemarker模板引擎结合node puppeteer库实现html生成图片

效果图：

先看效果图，以下是基于freemarker模板渲染数据，puppeteer加载html中的js及最后图片生成：

背景：

目前为止，后台java根据html模板或者一个网页路径生成图片，都不支持flex布局及最新的css3属性，这其中的库、插件包括：html2image、cssbox、core-renderer、wkhtmltox、Flying Saucer、node插件phantom 等等，浏览器标签页打开好几十个了😀😀😀很多插件库已经不记得了。经过粗略测试，对flex布局都不支持！

freemarker模板集成及实现：

因为是测试，所以后台模板页面只写了几个css3属性
1、springboot集成freemarker

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

2、freemarker配置项

# application.yml
spring:freemarker:cache: false# 字符集charset: UTF-8# 检查模板位置check-template-location: true# 模板内容类型content-type: text/htmlexpose-request-attributes: trueexpose-session-attributes: truerequest-context-attribute: request# 模板位置template-loader-path: classpath:/templates/# 必须要加 后缀，要不找不到接口suffix: .ftl

3、编写模板 f01.ftl

<!DOCTYPE html>
<html lang="en">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>freemarker模板</title><#-- 引入条形码库JsBarcode --><script src="https://cdn.jsdelivr.net/npm/jsbarcode@3.11.5/dist/JsBarcode.all.min.js"></script>
</head>
<body style="font-size: 20px;"><div style="display: flex;align-items: flex-start;border: 1px solid darkred;box-shadow: 1px 2px 1px 5px #cccccc;"><div style="display:flex;flex-shrink: 0;width:100px;">渲染文字:</div> <h1>${msg}</h1></div><div style="display: flex;align-items: center;margin: 10px 0px;"><div>渲染图片: </div><img style="width: 150px;height: 150px;" src="${img}" /></div><#--条形码--><#--<div style="display: flex;align-items: flex-end;">-->渲染条形码: <svg id="barcode"></svg><#--</div>-->
</body>
<#--用浏览器访问，可以加载js-->
<script>let e = document.getElementById("barcode");JsBarcode(e, "Hi world!");
</script>
</html>

4、创建接口

之所以创建一个接口，因为测试的时候我是通过接口方式，返回了一个html页面，在使用 puppeteer 生成图片时，可以指定一个网页或者html代码都可以。

@Slf4j
@Controller
public class Test2 {@RequestMapping(value = "/ftest")public String test(Model model) {model.addAttribute("msg", "freemarker模板引擎结合node puppeteer库实现html生成图片，划重点：【支持flex布局等所有的css3属性！！！】");model.addAttribute("img", "https://img1.baidu.com/it/u=3764156347,3722190225&fm=253&fmt=auto&app=138&f=JPEG?w=440&h=419");return "f01";}
}

5、网页测试

我们先在网页上调用接口测试下，看接口、页面是否正常，以下是网页展示的效果。

node puppeteer库下载、实现最终html转图片：

1、下载puppeteer时，可能会有点慢，取决于网络。

// 我下载的是22.1.0，最新版本下载的时候报错了，可能是node版本问题
// 电脑node版本为19.0.0
npm i puppeteer@22.1.0
// 或
yarn add puppeteer@22.1.0

2、使用puppeteer

page.evaluate() 方法会执行网页或者html中的js代码，这块很关键！上边我们在模板中引入的条形码生成插件，条形码是需要执行js来生成，所以必须且只能在page.evaluate() 方法中执行html中的js代码。其他的没啥说的，注释写的很清楚。

// index.js
const puppeteer = require('puppeteer');
async function test () {// 启动浏览器const browser = await puppeteer.launch();// 创建一个新页面const page = await browser.newPage();// 下边设置视口的长宽await page.setViewport({width: 960,height: 760,deviceScaleFactor: 1,});// todo 1 可以加载一段html代码// await page.setContent(imgHTML);// todo 2 也可以访问一个网址（下边这个网址是本地springboot后台接口，会返回一个html页面）await page.goto('http://localhost:8001/ftest');// 执行您自己的代码await page.evaluate(() => {let e = document.getElementById("barcode");JsBarcode(e, "Hi world!");});// 截取网页的屏幕截图await page.screenshot({path: "./example.png"});// 关闭浏览器await browser.close();
}
test()

3、执行index.js，图片生成测试，效果还是比较理想的，flex布局及条形码都会展示出来：