Element Plus 静默打印集成

在 Vue 3 + Element Plus 后台中,表格、描述列表、对话框内容均可提取 HTML 后调用 printHtml 静默出纸。与 Vue 专题 架构相同。

准备工作

集成思路

用 ref 获取表格容器 DOM,或使用模板字符串生成打印 HTML;点击「打印」按钮时调用 printHtml。详见 打印参数。

Element Plus 表格打印示例

在 setup 中封装打印方法:

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

实践建议

  • el-table 打印建议克隆表格 DOM 或单独写打印模板,避免侧栏菜单进入纸面。
  • 弹窗内打印:在 el-dialog 打开状态下获取内容区 HTML。
  • 打印前 getConnectStatus() 预检客户端;失败见 错误处理。
  • 与 Vite / Vue CLI 均兼容,无需额外 webpack 配置。

Element Plus 表格打印常见坑

el-table 打印最容易把侧栏、分页器、固定列阴影一起打进纸面。建议单独维护打印 DOM 或模板。

  • 侧栏/menu:只克隆 .el-table 容器,勿取 #app 根节点
  • 固定列:固定列会生成重复 DOM,打印前可移除 .el-table__fixed 或改用纯 HTML 模板
  • 分页:默认只打当前页;全量数据需服务端分页导出或前端合并 HTML
  • 对话框:el-dialog 打印时确保 append-to-body 内容已渲染完成

与本站专题分工

常见问题

Element Plus 表格能静默吗?

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

需要改 Element 源码吗?

不需要。仅在前端获取 DOM 或模板字符串即可。

和 hiprint 呢?

hiprint 偏可视化设计器;HTML 报表用 web-print-pdf 更轻。见 hiprint 对比。

el-table 固定列打印重复怎么办?

固定列会复制表格 DOM。打印前移除 fixed 列容器,或使用不含 fixed 的打印专用模板。

Vite 开发环境连不上客户端?

与框架无关——先确认客户端已启动,getConnectStatus() 预检。见 错误处理。

各平台客户端部署

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

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