先给结论: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 三行代码就能交差,别过度设计。判断标准回到那张表:模板不用用户改、不分页、不要条码,轻量库足够;这三项里占了两项,迁移成本几天就赚回来了。