React 静默打印需要额外插件吗?
不需要浏览器插件。需安装 Web打印专家本地客户端,并在项目中 npm install web-print-pdf。
在 React 18 项目中使用 web-print-pdf 实现静默打印:不弹出浏览器打印对话框,由本地客户端完成 HTML 转 PDF 并驱动打印机。架构与 Vue 专题 相同,下文给出 React Hook 写法。
npm install web-print-pdfReact 页面调用 printHtml → npm 包经本地 WebSocket 提交任务 → 客户端渲染 PDF 并静默出纸。详见 window.print 替代原理。
封装 useSilentPrint,在按钮事件中传入打印区域 HTML:
import { useCallback, useState } from 'react';
import webPrintPdf from 'web-print-pdf';
export function useSilentPrint() {
const [loading, setLoading] = useState(false);
const printHtml = useCallback(async (html) => {
setLoading(true);
try {
return await webPrintPdf.printHtml(
html,
{ paperFormat: 'A4', printBackground: true },
{ paperFormat: 'A4', printerName: 'Default printer' }
);
} finally {
setLoading(false);
}
}, []);
return { loading, printHtml };
}
import { useSilentPrint } from './useSilentPrint';
export function OrderPrintButton({ html }) {
const { loading, printHtml } = useSilentPrint();
return (
<button disabled={loading} onClick={() => printHtml(html)}>
{loading ? 'Printing…' : 'Silent print'}
</button>
);
}
@media print 或专用 CSS 文件。window.print 弹窗。webPrintPdf.utils.getConnectStatus() 确认客户端在线。不需要浏览器插件。需安装 Web打印专家本地客户端,并在项目中 npm install web-print-pdf。
可以。在客户端组件(如 use client 区域)中 import 并调用 printHtml 即可,打印逻辑仅在浏览器端执行。
npm API 完全一致,仅 React 侧用 Hook/事件绑定方式组织代码。协议细节可参考 Vue 专题中的 WebSocket 说明。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。