打印控件选型:轻量库与 vue-print-designer 的边界

0 阅读1分钟

先给结论:vue-print-nb 是“打印当前页面”,vue-print-designer 是“设计并生成打印内容”

先回答被搜得最多的那句话:vue-print-nb 打印的是当前页面,vue-print-designer 打印的是设计出来的内容。

展开一点。vue-print-nb 干的事,是把已经渲染好的 DOM 抓过来塞进 iframe,调 window.print()。它不关心你打印什么,只负责把页面送到打印机。所以你的版式长什么样,取决于前端代码怎么写。

vue-print-designer 干的是另一段:让业务人员自己在浏览器里拖表格、拉字段、调列宽,存成模板,打印时用数据填充模板再输出。前端只提供一个容器和一份数据。项目地址:gitee.com/theGreatOld…

<!-- 轻量库:版式写死在模板里 -->
<div id="printArea">
  <div v-for="row in rows" :key="row.id" class="line">
    {{ row.name }} × {{ row.qty }}
  </div>
</div>
<button v-print="'#printArea'">打印</button>
<!-- 控件:版式来自后台存的模板 -->
<PrintDesigner :template-id="tplId" :data="rows" @print="onPrint" />

区别落到工程上,就是「谁改版式、改一次多久」。

判断标准我只留三条,问自己:

判断项否是
模板要不要用户自己改版式前端写死运营要能拖拽调整
是否跨页表格 / 标签 / 票据单页简单排版分页、套打、连续纸
是否多人共用同一套模板一个人用,改了自己发版多门店、多角色共用

三条全否,vue-print-nb 够用,别上控件。任一为是,早晚要换。

拿实测说话。同一张 12 行小票模板,字段是商品名、数量、单价、小计:

  • vue-print-nb:接入到跑通约 0.5 人天。第一次很爽。但客户说“小计列往左挪 10mm”“字号从 12 改 10”,你得改 .line 的样式,走一遍提测、发版。一年改 8 次版式,就是 8 次前端发版。
  • vue-print-designer:接入约 1.5 人天,多出来的是把模板存哪、字段怎么映射这两件事定下来。之后改版式,运营在后台拖,保存即生效,前端零改动。

多花的 1 人天,在第二次改版式的时候就回来了。

还有一个容易被忽略的点:浏览器打印本身不保证像素级一致。Chrome 和 Edge 对 @page 的 margin 处理就有出入,Firefox 更随意。轻量库把 DOM 丢给浏览器,这个差异直接落到纸面上;vue-print-designer 在输出前按模板坐标重排,把分页位置和边距收在自己手里,套打场景下这点差别很明显。

所以结论很短:版式不由用户改、内容不跨页、模板不共用,用 vue-print-nb;占任意一条,用 vue-print-designer。 后面几节只是把这三条量化成具体数字。

奶茶店 小票

候选方案摆一桌:手写 window.print、vue-print-nb、打印控件

三个候选,先摆一桌,各自的边界一眼能看出来。

A. window.print + @media print

零依赖,一行 window.print() 就能弹窗。代价全压在 CSS 上:分页靠 page-break-after: always,纸张尺寸靠 @page { size: 80mm auto },页眉页脚要在打印对话框里手动关。最烦的是浏览器不一致——Chrome 的默认页边距是 10.16mm(0.4 英寸),Safari 走自己那套,同一个模板两边打出来内容宽度差 3~5mm,套打票据直接越框。更麻烦的是 @page 的 margin 和用户在打印对话框里选的「边距:默认/无」会打架,你写死了也未必生效。这套方案适合固定纸张、单页、不在乎毫米级偏差的内部页。

B. vue-print-nb

本质是一条 v-print 指令,把元素 id 对应的 DOM 整个丢给浏览器。最小用法就这些:

<template>
  <div id="receipt">
    <div v-for="row in rows" class="line">
      {{ row.name }} × {{ row.qty }} ¥{{ row.subtotal }}
    </div>
  </div>
  <button v-print="'#receipt'">打印小票</button>
</template>

<script setup>
import { ref } from 'vue'
const rows = ref([{ name: '拿铁', qty: 2, subtotal: 36 }])
</script>

<style>
@media print {
  @page { size: 80mm auto; margin: 2mm; }
  .line { font-size: 10pt; }
}
</style>

三行接完,够轻。天花板也在这段代码里:版式写死在 .line 的样式和模板结构里,运营要「小计列左移 10mm」,得前端改 CSS、提测、发版;@page 那行在不同浏览器表现不一,运行时没有任何地方能校验。它把排版能力留在了模板字符串里,也把改版成本留给了前端。

C. vue-print-designer

可视化设计器拖出模板,存成 JSON,渲染时按模板坐标重排,分页位置、页边距、纸张尺寸由控件自己算,不交给浏览器的打印对话框。版式归运营,代码只负责把行数据喂进去。多出来的接入成本是把模板存哪、字段怎么映射定下来,定完就不再反复。

定位

vue-print-nb 不是要对着打的竞品,是迁移起点。多数项目就是先用它三天跑通打印,等模板要用户自己改、要跨页续打、要多门店共用同一套版式,维护成本压不住了,再迁到 vue-print-designer。迁的时候模板字段和行数据结构基本能对上,不是推倒重来。

餐饮后厨小票

对比表格:把“够用”和“不够用”划成一张表

维度轻量库(vue-print-nb)vue-print-designer
模板是否可配置否,版式写在 .vue 模板和 @media print 里,改一行要动代码是,设计器拖出模板存 JSON,运营在后台改,前端不参与
分页与跨页表格靠浏览器自动分页,表格跨页断行、表头不重复、行被截断都出现过分页位置由控件按行高计算,表头可设重复,跨页行不裁切
纸张/标签尺寸自定义@page { size: 58mm auto } 写死,Chrome 和 Firefox 表现不一致纸张、标签宽高在模板里配,58mm 小票、A4、吊牌尺寸都能存
条形码二维码不支持,得自己引 jsbarcode / qrcode,再塞进 DOM 截图内置条码、二维码组件,值绑字段,尺寸随模板缩放
数据绑定方式直接渲染 Vue 响应式数据,改字段就改模板模板坐标 + 字段映射,行数据喂进去按模板重排
改版成本前端改 CSS → 提测 → 发版,一次 0.5~1 人天运营后台改模板,改完即生效
接入人天0.5~1 人天跑通3~5 人天,成本在模板存哪、字段怎么映射
适用场景合同、详情页、简单小票后厨小票、吊牌、条码标签、发票

拿一组实数看改版成本:50 家门店,每周改一次小票版式,轻量库方案一年约 50 次前端发版,每次提测加发布按半天算,25 人天消耗在改版式上。换成 vue-print-designer,模板存在后台,店长自己拖,一年 0 次前端发版。

后厨小票和服装吊牌是轻量库最容易翻车的两类。小票要 58mm 定宽,浏览器打印对话框里用户一选 A4 就全乱,自动切纸还依赖驱动;@page 里 size: 58mm auto 在部分浏览器被忽略,出来是半页空白。吊牌要一页多联,A4 排 12 张,每联带条码和尺码,轻量库只能用 CSS grid 硬拼,拼完发现第二页起始位置偏 3mm,切出来整批废。

这张表里「模板可配置」「条码」「标签尺寸」三行,就是 vue-print-designer 相对轻量库的能力边界。三行里有两行不满足,轻量库就开始亏人天;三行都要,直接上控件。

如果只是详情页加个「打印」按钮,vue-print-nb 三行代码就能交差,别过度设计。判断标准回到那张表:模板不用用户改、不分页、不要条码,轻量库足够;这三项里占了两项,迁移成本几天就赚回来了。