餐饮 / 零售热敏小票
pdfOptions 指定纸宽(如 80mm)、html/body margin 归零避免多页;适合 POS、外卖档口。见 80mm 在线样例。
零售小票、餐饮 80mm 热敏纸、WMS/OMS 快递面单与标签,常见需求是无浏览器弹窗、指定热敏打印机、批量出纸。用 HTML/CSS 描述版式,经 web-print-pdf 转 PDF 后由本地客户端静默打印——Windows 收银机、macOS 门店 PC、Linux/信创仓库终端 可共用同一套前端代码。
版式用 HTML/CSS 描述纸宽。本地场景:浏览器调 printHtml / batchPrint 出纸;远程高峰:不调 npm,把同结构任务提交到自建接收服务,工位客户端配置消费接口 URL(见 远程打印、WMS 推送)。
npm install web-print-pdf,按纸宽编写 HTML/CSS(热敏纸务必 margin:0),调用 printHtml 或 batchPrintawait webPrintPdf.printHtml(
receiptHtml,
{ width: '80mm', height: '120mm', printBackground: true },
{ printerName: 'Thermal printer', copies: 1 }
);
width/height(如 80mm)而非 A4html, body { margin:0; padding:0; }printOptions.printerName 填热敏机名称(客户端枚举)sharp: true,消除文字边缘锯齿(仅热敏机需要)batchPrint;参数详见 打印参数专题| 纸型 | pdfOptions 要点 | 常见场景 |
|---|---|---|
| 80mm 小票 | width: 80mm,HTML margin:0 | 餐饮、零售 POS |
| 100×150 面单 | 精确 width/height,归零边距 | 快递、WMS |
| A4 报表 | paperFormat: A4 | 见 打印参数 |
printerName 与客户端枚举多为 body 默认 margin 或纸高设置过大。参考 80mm 样例归零边距,并核对 pdfOptions 的 width/height 与物理纸宽一致。
可以。window.print 无法静默;web-print-pdf + 本地客户端可 silent print 到指定热敏机。
可以。在自有服务端按固定格式接收/存储任务并暴露 WebSocket/HTTP 消费接口,工位客户端配置该 URL 后自动出纸——不需要在网页调 webPrintPdf.printHtml(npm 仅作字段格式对照)。见 远程打印专题。
支持。官方提供 macOS dmg 与 Linux deb(含麒麟/UOS),与 Windows 使用相同 printHtml API。
许多快递面单适合 HTML 化 PoC;精密套打可继续 Lodop 并行。见 Lodop 并行接入指南。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。