开源网页打印控件对比:hiprint 与 vue-print-designer 模板能力

先给结论:开源网页打印控件推荐清单里,谁适合做单据模板

先说结论:要做带表格和条码的单据模板,优先看 vue-print-designer。它是 Vue 组件形态,设计器开箱即用,模板存成 JSON,业务方改字段、改列宽、改样式不用回头翻源码。hiprint 更适合当对照基线------生态起得早,网上示例多,但文档散在各处,遇到分页和表格嵌套的问题常常得靠翻 issue 和读源码解决。

直接上对比:

维度 它 hiprint
设计器形态 Vue 组件,引入即用,设计器与渲染器同一套 独立设计器,需按版本对接,API 随版本有出入
表格/条码支持 表格支持合并单元格与动态行,条码内置 code128、ean13 等常用类型 表格与条码均有,条码类型需按文档配置,部分类型要额外引依赖
分页方式 模板内按纸张设置分页,表格可设置续打表头 通过分页面板配置,复杂表格跨页时表头续打需要调参
数据绑定模型 模板即 JSON,字段路径直接写在模板里,渲染时传数据对象 以模板 JSON 加数据源绑定,字段映射依赖设计器导出结构
许可证与二次开发成本 MIT,源码可改,样式层是普通 CSS 开源版可用,深度定制需读源码,版本升级时改动点要重新核对

适用边界说清楚:hiprint 的存量模板多,如果团队手里已经有一批跑着的模板、只想快速迁到新项目里验证,拿它当基线跑一遍是合理的。但它的文档散,新手上手做一张带条码的表格单据,光找"表格列宽怎么绑数据"这一条就可能翻半小时。该方案 这边模板就是一段 JSON,改个列宽、换个条码类型,直接改 JSON 里的字段值,不用进源码里找渲染逻辑。

本文的评测方式不靠看 demo:同一张「销售出库单」------表头带单号日期、明细表 8 列含金额小计、底部一个 code128 条码------两边各做一遍,记录三个数:从零到出第一张打印预览的耗时、模板配置文件的行数、过程中卡住的次数。后面几节会把这些数摆出来。

最后提醒一句:控件选型先看模板能不能被业务改。demo 好看不代表业务能自己维护,一张单据上线后改列、加字段是常态,模板结构越接近普通配置,后面越省事。

评测维度与同场景题目:一张带表格和条码的出库单

题目固定成一张「销售出库单」,不换。A4 纵向,页边距按 Chrome 默认打印边距走,不再单独调。版式三块:表头 3 个字段(单号、日期、客户),明细表 8 列(序号、品名、规格、单位、数量、单价、金额、备注),右上角一个 Code128 条码,内容取单号;每页页脚右侧放「第 X 页 / 共 Y 页」。

测试数据统一 200 行明细,金额列由数量乘单价算出,带两位小数。行数固定,是为了让两边跨页位置可比------200 行在 A4 上大约压到第 4 页,表头续打和不续打的差别一眼能看出来。

五个维度,各 0--5 分:

维度 看什么 5 分的标准
设计器可用性 拖字段、调列宽、改条码类型要不要翻文档 全程不查文档能做完
表格与分页 8 列宽度、跨页表头续打、页脚页码 跨页表头自动续,页码不用手写
条码/二维码 Code128 是否内置、内容能否绑字段 选类型、绑字段两步完成
数据绑定 字段路径怎么写、循环行怎么声明 模板里直接写路径,渲染只传对象
导出与打印保真度 预览和出纸的列宽、分页位置是否一致 预览即所得,偏差不超过 1mm

扣分规则写死,避免事后扯皮:每踩一个坑扣 1 分,同一类坑只扣一次。坑的定义限死为三种------查文档超过 10 分钟没找到答案、改配置后预览报错、需要改源码才能过。代码量按有效行统计,空行和注释不算。设计器可用性和保真度这两项主观,两个人各打一遍取均值,分差超过 1 分就当场重看一遍再定。

为什么不拿复杂报表当题目。带分组汇总、交叉表、子报表的报表确实更能压出控件的极限,但实际项目里这类需求占比小,多数人要做的是单据:表头、明细、条码、页码,四件事。拿单据跑分,结论能直接搬到下一个项目;拿交叉表跑分,跑完还是不知道普通单据顺不顺手。

环境提前交代清楚,免得后面数据对不上:Chrome 120,Vue 3 + Vite,同一台激光打印机,同一批 200 行数据,纸张 A4 80g。两边都不做打印样式微调,控件默认出什么就是什么------保真度这一项比的本来就是默认表现。

数据绑定的写法差异,从模板片段就能看出来。表格行区域声明一个循环,列上直接写字段路径:

json 复制代码
{
  "type": "table",
  "dataKey": "items",
  "columns": [
    { "title": "品名", "field": "items.name" },
    { "title": "数量", "field": "items.qty" },
    { "title": "金额", "field": "items.amount" }
  ]
}

渲染时传 { no, date, customer, items: [...] } 就行,不用再建一层字段映射表。条码同理,"content": "{``{no}}",类型填 code128。这种「模板即配置」的结构,业务方改列、加字段时改 JSON 即可,不用进渲染逻辑里找。

下面几节按这五个维度逐项跑,每个维度给分数、给耗时、给卡住的位置。

设计器横评:拖拽体验、表格嵌套与条码生成

拖拽手感这一项,两边都不算好,但改模板的成本差一个量级。先给结论:设计器本体的功能完备度,hiprint 更全;但模板的可维护性,JSON 描述那一侧赢。

hiprint 的设计器该有的都有,标尺、网格、吸附、多选对齐,第一次上手十分钟能拖出一张单据。问题出在细调:表格列宽拖动没有数值输入,对齐靠肉眼,20 行明细里想让「数量」列右边缘跟表头对齐,来回拖了 6 次才勉强齐。条码更麻烦,控件本身不生成图形,得自己接 JsBarcode,把 canvas 塞进元素里,再处理一次打印缩放。改样式时最费时间------颜色、字号散在配置结构的不同层级,改一次得翻一遍,查文档花了 14 分钟才确认表头样式的键名,这一项按规则记一次坑。

另一边的模板是纯 JSON,表格列配置、条码类型都是字段,改完直接存库,业务方在后台自己调列宽和条码内容,不用找前端。注册并预览一个带表头、明细表、条码的模板,代码就这些:

json 复制代码
{
  "name": "delivery-note",
  "version": 3,
  "paper": { "size": "A4", "margin": [10, 10, 10, 10] },
  "elements": [
    { "type": "text", "x": 10, "y": 8, "content": "送货单", "fontSize": 16 },
    { "type": "text", "x": 10, "y": 20, "content": "客户:{{customer}}" },
    { "type": "barcode", "x": 150, "y": 8, "w": 45, "h": 14,
      "symbology": "code128", "content": "{{no}}" },
    { "type": "table", "x": 10, "y": 40, "w": 190, "dataKey": "items",
      "headerHeight": 8, "rowHeight": 7,
      "columns": [
        { "title": "品名", "field": "items.name", "width": 70 },
        { "title": "数量", "field": "items.qty", "width": 25, "align": "right" },
        { "title": "金额", "field": "items.amount", "width": 35, "align": "right" }
      ] }
  ]
}
js 复制代码
// 存模板 → 拿版本号 → 用真实数据预览
const tpl = await fetch('/templates/delivery-note.json').then(r => r.json())
const { id, version } = await designer.save(tpl)   // 落库,version 自增

designer.preview(id, {
  no: 'DN20240612-001',
  customer: '杭州某某贸易',
  items: [{ name: 'A4 复印纸', qty: 20, amount: 380 }]
})

两边共同的短板是「表格内嵌条码列」。表格列只认文本字段,条码得当成独立元素,按行坐标一行行铺:y = 表头高 + 行号 × 行高。行高从 7mm 改成 8mm,20 行的坐标全部重算,改一次写一个循环。明细行数动态变化时,还得在渲染前先算总行数再生成元素,不能交给表格自己撑开。这一项谁也没做干净,别指望开箱即用。

小结:设计器功能全不全,hiprint 不输;但模板可版本化、可 diff,改一列能看出改了什么,团队协作不打架。这一项记 JSON 侧胜。

数据绑定与分页:谁的结构更好维护

先说结论:数据绑定方式决定后期维护成本。hiprint 通过 provider 回调取数,字段映射写在函数里;换一个字段名要改代码、重新构建、重新发版。schema 绑定把字段路径写在模板 JSON 里,接口改名时只改 JSON,构建流程不动。

看同一份 200 行明细的写法。hiprint 侧:

js 复制代码
const provider = {
  printData: (data) => ({
    items: data.detailList.map(r => ({
      name: r.goodsName,        // 接口字段 goodsName → 模板字段 name
      qty: r.num,
      amount: r.money,
      rowNo: r.seqNo
    }))
  })
}
hiprint.init({ providers: [provider] })

字段映射、类型转换、缺省值全在 map 里。接口把 goodsName 改成 productName,得搜出所有 provider 改一遍;有 5 个单据模板,就改 5 处。

schema 侧:

json 复制代码
{
  "type": "table",
  "dataSource": "detailList",
  "columns": [
    { "title": "品名", "field": "goodsName", "width": 70 },
    { "title": "数量", "field": "num", "width": 25, "align": "right" },
    { "title": "金额", "field": "money", "width": 35, "align": "right" }
  ],
  "pagination": { "rowsPerPage": 18, "repeatHeader": true, "keepRowsIntact": true,
                  "footer": { "pageNo": "第 {page} 页 / 共 {total} 页" } }
}

字段路径直接写列上,接口改字段就改 JSON 里那一个字符串,保存后 version 自增,预览立刻生效。不用碰构建,也不用发版。

分页实测:200 行、每页 18 行、A4 纵向。两边都能做到跨页重复表头、行不被截断,差异在配置成本。hiprint 要重写 onPageBreak 回调,自己算偏移、补表头元素、拼页码文本;我调了 4 次才对上页脚位置。schema 侧上面那段 pagination 就是全部配置,第一次跑通,试错 0 次。页码占位符 {page}、{total} 由渲染器替换,不用写函数。

关键在分页策略是模板属性,不是代码逻辑。每页行数、表头重复、行不断裂、页脚页码,业务在模板里配,改单据不用找前端。hiprint 也能做,但每换一种单据就要复制一份回调,回调之间还容易不一致。

一个坑:rowsPerPage 设 18 时,如果某行内容换行撑高,实际每页只能放 17 行。schema 侧靠 keepRowsIntact 自动下移,不用手算;hiprint 侧要在回调里量高度,量不准就出现半行跨页。这块建议留 1 行余量,把 rowsPerPage 设成 17。

落点:把分页做成模板属性,业务可配,代码只负责渲染。