Ant Design / Pro 静默打印集成

在 React + Ant Design 或 Ant Design Pro 后台中,Table、ProTable、Modal 内容可提取 HTML 后调用 printHtml 静默出纸。基础用法见 React 专题。

准备工作

集成思路

用 ref 包裹表格容器,或生成仅含报表的 HTML 字符串;在「打印」按钮中调用 printHtml。参数见 打印参数。

Ant Design Table 打印示例

封装 Hook(与 React 专题相同模式):

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 };
}

ProTable / Table 工具栏绑定

import { useSilentPrint } from './useSilentPrint';

export function OrderPrintButton({ html }) {
  const { loading, printHtml } = useSilentPrint();
  return (
    <button disabled={loading} onClick={() => printHtml(html)}>
      {loading ? 'Printing…' : 'Silent print'}
    </button>
  );
}

实践建议

  • Table 建议克隆 .ant-table-content 或单独维护打印模板,避免把 ProLayout 侧栏打进纸面。
  • Modal 内打印:在打开状态下获取内容区 DOM。
  • 打印前 getConnectStatus();失败处理见 错误处理。
  • 与 Umi、Vite、CRA 均兼容;TypeScript 类型由 web-print-pdf 内置。

Ant Design Table / ProTable 打印常见坑

ProLayout 侧栏、ProTable 搜索栏、固定列与横向滚动条是常见「多打内容」来源。

  • ProLayout:只取 .ant-table-content 或打印模板,勿打印整页 layout
  • ProTable 搜索区:工具栏「打印」应绑定表格 DOM,而非 Form 区域
  • 固定列/横向滚动:与 Element 类似,fixed 列会重复——用打印模板更稳
  • Modal/Drawer:在打开状态下抓取内容区 HTML

与本站专题分工

常见问题

Ant Design Table 能静默吗?

可以。提取表格 HTML 后 printHtml,由本地客户端输出。

ProTable 搜索栏会进纸面吗?

默认会。请只选取表格区域或专用打印模板。

和 react-to-print 区别?

react-to-print 多走浏览器对话框;web-print-pdf 实现静默与指定打印机。

ProTable 搜索表单会进纸面吗?

默认会。请只选取表格区域或维护专用打印 HTML 字符串。

Umi / CRA 项目如何接?

与构建工具无关:npm install web-print-pdf 后直接 import。TypeScript 类型内置。

各平台客户端部署

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

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