前言

打印这件事，在企业系统里绕不开。订单要打、发货单要打、报表要打、合同也要打。但Web项目里实现打印总是有点别扭，要么用浏览器自带的打印功能，样式调起来很折磨人；要么集成第三方控件，体积大、配置复杂、还得安装一堆东西。

它是一套Web打印服务解决方案，核心思路很直接：让非技术人员也能通过拖拉拽设计打印模板，业务系统通过简单的接口调用就能完成打印。这篇文章从实际使用的角度，聊聊这套方案能做什么、怎么用，以及适合什么场景。

项目介绍

一套面向Web应用的打印服务解决方案，包含可视化模板设计器和后台打印服务两个核心部分。

模板设计器是一个在线工具，用户通过拖拉拽的方式布局打印元素，设计完成后生成JSON格式的模板数据。后台打印服务接收这个JSON数据和业务数据，渲染成打印结果发送到打印机。

这套方案支持在线和离线两种使用方式，既可以访问官网的在线设计器直接使用，也可以将设计器代码包部署到本地局域网服务器上。后台打印服务需要在Windows环境安装，安装包从官网下载中心获取。

项目功能

项目特点

• 所见即所得：设计器界面和最终打印效果基本一致，调整起来很直观

• 非技术人员可用：不需要懂HTML和CSS，拖拉拽就能搞定模板设计

• 集成门槛低：只需几行调用代码，不需要引入额外的JS文件

• 兼容主流浏览器：Chrome、Firefox、Safari等常用浏览器都能用

• JSON数据驱动：模板采用JSON格式，业务系统可以动态替换内容

• 免费可用：带水印版本可以免费使用，商用授权需要付费

• 表格处理能力强：列表元素支持分页、分页合计、行补全、数据绑定等功能

项目技术

项目代码

调用方式非常简单，基本上就是构造好模板JSON和数据，然后通过Ajax POST提交给后台打印服务。

前端调用示例（直接通过Ajax提交）

// 模板JSON从设计器导出
var templateData = {
// 设计器生成的模板结构
"elements": [...],
"layout": {...}
};

// 业务数据，替换模板中的变量
var printData = {
"orderNo": "ORD-2026-001",
"customerName": "某某公司",
"items": [...]
};

// 调用后台打印服务
$.ajax({
url: "http://localhost:8080/print",
type: "POST",
data: JSON.stringify({
    template: templateData,
    data: printData
  }),
success: function(response) {
    console.log("打印任务已提交");
  }
});

静默打印调用

// 直接打印，不弹出预览窗口
$.ajax({
  url: "http://localhost:8080/print/silent",
  type: "POST",
  data: JSON.stringify({
    template: templateData,
    data: printData,
    printer: "默认打印机"
  })
});

导出PDF调用

根据官方提供的用法，只需要将模板JSON作为参数传入，就能将打印内容以PDF格式下载到本地。

var template = encodeURIComponent(JSON.stringify(templateData));
window.open("/export/pdf?template=" + template);

设计器生成的模板JSON包含了完整的布局信息、元素位置、样式属性等。业务系统拿到这个JSON后，只需要替换其中的动态内容（比如文本值、图片Base64、条码值域等），就能生成不同的打印任务。

项目效果

模板设计器采用可视化的操作方式，页面左侧是元素工具栏，中间是画布区域，右侧是属性面板。用户从左侧拖拽文本、图片、条码、二维码、线条等元素到画布上，调整位置和大小，再通过属性面板设置字体、颜色、边框等样式。

列表元素是2.0版本的重点功能。设计器中可以为列表配置列属性、分页参数、汇总规则等。打印时，系统自动根据数据行数计算分页，每页显示指定行数，最后一页不足时自动补全空白行。每页底部可以显示本页小计，最后一页显示总计。

对于企业单据套打场景，比如订单、出库单、发票等，这套设计器可以快速搭建出符合业务需求的打印模板，整个过程不需要写代码。

项目源码

在线使用：直接访问官网的在线设计器进行模板设计，下载JSON模板文件后导入自己的业务系统。

离线部署：在官网下载中心获取设计器代码包，部署到本地Web服务器上使用。后台打印服务需要单独下载安装包，按照说明安装配置。

总结

Web项目里怎么让非技术人员也能搞定打印模板。它把模板设计这件事从写代码变成了拖拉拽，把调用方式简化成了几行Ajax。对于经常要处理订单、报表、单据打印的企业系统来说，这套方案能省不少事。

当然它也不是万能的。免费版本带水印，商用需要付费授权；后台打印服务基于Java，对于纯.NET或PHP的技术栈可能需要额外部署。但总的来说，如果项目里有大量打印需求，尤其是需要频繁调整模板格式的场景，Peach-Printer值得一试。

关键词

#Web打印，#可视化模板设计器，JSON模板，静默打印，#表格分页，汇总统计，导出PDF，打印服务，#拖拉拽设计，企业单据打印，套打，#打印控件

阅读原文：点击这里