收银和小票场景对「静默」几乎刚需:排队时每单弹一次系统打印框,现场会直接放弃。80mm 热敏和 A4 激光不是同一套纸张参数——纸宽、边距、字体加粗,错一点就切纸难看或内容出界。
架构仍然是那一套
浏览器页面 → 前端 SDK(如 web-print-pdf)→ 本机打印客户端 → 热敏机队列。
不要指望纯前端 window.print() 在柜面长期稳定无弹窗。
纸张与版式
- 物理纸宽常见 80mm(也有 58mm),以门店实际耗材为准。
- HTML 里按毫米或合适像素控制内容宽度,避免按 A4 思维留巨大空白。
- 热敏对细线、浅灰、小字不友好;关键金额用足够字号与对比度。
- 切刀/黑标属于打印机与驱动行为,SDK 只能把任务送到队列。
import webPrintPdf from 'web-print-pdf';
const ticketHtml = `
<div style="width:72mm;font-family:monospace;font-size:12px;">
<div style="text-align:center;font-size:16px;font-weight:bold;">门店小票</div>
<div>单号:A20261118001</div>
<div>餐品A × 1 18.00</div>
<div>餐品B × 2 32.00</div>
<hr />
<div style="font-size:14px;">合计:50.00</div>
</div>
`;
await webPrintPdf.printHtml(
ticketHtml,
{
width: '80mm',
margin: {
top: '2mm', bottom: '2mm', left: '2mm', right: '2mm' },
printBackground: true,
},
{
printerName: '收银热敏机名称', copies: 1 },
{
action: 'print' }
);
不同版本对 width / paperFormat 的支持可能不同,以当前版本文档为准。
现场 checklist
| 项 | 说明 |
|---|---|
| 打印机名 | 与系统完全一致;换驱动后名称常变 |
| 客户端在线 | 收银机开机自启是否勾上 |
| 先预览 | 用 preview 看是否裁切 |
| 试打三单 | 连打是否重叠、是否丢任务 |
| 字体 | 工位缺字体时中文会糊或方框 |
小结
80mm 静默小票的关键是纸宽参数 + 干净 HTML + 指定热敏机 + 客户端常驻。
npm install web-print-pdf