熟悉 Lodop 的同事,脑子里通常有这些动作:初始化、设纸张、指定打印机、加内容、PRINT。换到「本机客户端 + npm SDK」时,动作还在,只是 API 形状变了。本文用对照方式,帮你半小时打通一张样张——不承诺也不暗示可以无损替换全部 Lodop 模板。
概念对照(帮助沟通,不是 API 映射表)
| 你在 Lodop 里常做的事 | 在 web-print-pdf 一类方案里大致对应 |
|---|---|
| 本地控件/服务要就绪 | 本机打印客户端要安装并运行 |
| 指定打印机 | printOptions.printerName |
| 纸张/方向等 | pdfOptions / printOptions 中的纸张相关字段 |
| 加入 HTML 片段 | printHtml(html, …) |
| 预览 / 直接打 | extraOptions.action 为 preview 或 print(以当前文档为准) |
没有「一条指令等于 LODOP.XXX」的自动翻译器。套打坐标体系与 HTML/CSS 版式是两套世界观。
半小时实操
1. 环境
- 工位已装 Web打印专家客户端,托盘进程在线。
- 前端工程能安装 npm 包。
- 已知真实打印机名称(从系统打印机列表复制)。
2. 安装
npm install web-print-pdf
3. 最小出纸
import webPrintPdf from 'web-print-pdf';
async function poc() {
if (!(await webPrintPdf.utils.getConnectStatus())) {
console.error('客户端未连接:先启动本机打印服务');
return;
}
const html = '<div style="padding:12px;font-size:16px;">PoC 样张</div>';
await webPrintPdf.printHtml(
html,
{
paperFormat: 'A4', printBackground: true },
{
paperFormat: 'A4', printerName: '你的打印机名称' },
{
action: 'print', requestTimeout: 15 }
);
}
4. 对照验收
- 无浏览器系统打印对话框打断;
- 纸从指定打印机出来;
- 故意写错打印机名时,错误可感知。
从 Lodop 思维迁过来的三个坑
1. 以为 npm 包 alone 就能静默
包只是前端调用层;客户端没开,任务必失败。
2. 把整页后台 DOM 直接打出去
侧栏、顶栏、弹层都会进纸。打印前准备独立 HTML 或打印专用容器。
3. 用「默认打印机」糊弄多窗口现场
柜面往往多机。名称配置化,按工位下发。
小结
半小时只做样张闭环:客户端在线 → printHtml → 指定机出纸。过了这关,再逐票种评估,比一上来写迁移大计划靠谱。