React18 静默打印集成指南

在 React 18 项目中使用 web-print-pdf 实现静默打印:不弹出浏览器打印对话框,由本地客户端完成 HTML 转 PDF 并驱动打印机。架构与 Vue 专题 相同,下文给出 React Hook 写法。

准备工作

整体架构

React 页面调用 printHtml → npm 包经本地 WebSocket 提交任务 → 客户端渲染 PDF 并静默出纸。详见 window.print 替代原理。

React Hook 示例

封装 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>
  );
}

实践建议

  • 打印区域使用独立 DOM 片段或模板字符串,样式建议 @media print 或专用 CSS 文件。
  • 内网政务/金融场景常用静默打印,避免 window.print 弹窗。
  • 打印前调用 webPrintPdf.utils.getConnectStatus() 确认客户端在线。
  • Ant Design Pro、Umi 等脚手架与普通 CRA/Vite 项目接入方式相同,均为 import npm 包后调用 API。

常见问题

React 静默打印需要额外插件吗?

不需要浏览器插件。需安装 Web打印专家本地客户端,并在项目中 npm install web-print-pdf。

Next.js 可以用吗?

可以。在客户端组件(如 use client 区域)中 import 并调用 printHtml 即可,打印逻辑仅在浏览器端执行。

与 Vue 版有什么区别?

npm API 完全一致,仅 React 侧用 Hook/事件绑定方式组织代码。协议细节可参考 Vue 专题中的 WebSocket 说明。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

免费下载客户端 查看 npm 包 开发文档