如何运行「自定义纸张尺寸」在线样例？

安装并启动 Web打印专家客户端，在本页点击「运行打印」或「仅预览 PDF」。「自定义纸张尺寸」样例通过 web-print-pdf 连接本地 WebSocket 服务执行页面示例代码。

运行本样例是否需要在本地搭建 Vue 或 React 项目？

不需要。本页已内置 web-print-pdf 与示例代码，打开网页即可联调；正式接入时再在项目中 npm install web-print-pdf。

「自定义纸张尺寸」样例中的数据是真实业务数据吗？

不是。版式与金额均为虚构演示数据，仅用于展示 printHtml、水印、批量打印等 API 效果，不具备法律效力或物流效力。

在线样例

.demo-compat-banner--noscript { display: block !important; }

12 - 自定义纸张尺寸

pdf 用 width + height 指定非标准尺寸（勿同时设 paperFormat）。注意：pdfOptions.margin 设为 0 只影响 PDF 页边距，不会去掉 HTML 里 body 的默认边距（浏览器约 8px）；自定义小尺寸纸张时必须在 HTML 的 style 中写 html, body { margin: 0; padding: 0; }（见下方 labelHtml），否则内容总高度会超出页高，容易多出一页空白。实际打印时 printOptions.paperFormat 须填当前打印机物理纸名（getPrinterPapers 查询）。

自定义纸张尺寸：pdf 用 width + height 指定非标准尺寸（勿同时设 paperFormat）。注意：pdfOptions.margin 设为 0 只影响 PDF 页边距，不会去掉 HTML 里 body 的默认边距（浏览器约 8px）；

示例代码

const labelWidth = '100mm';
const labelHeight = '80mm';

const labelHtml = (n) => `<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    html, body { margin: 0; padding: 0; }
    .label {
      width: ${labelWidth};
      height: ${labelHeight};
      border: 1px solid #333;
      padding: 8mm;
      font-family: Arial, sans-serif;
      box-sizing: border-box;
    }
  </style>
</head>
<body>
  <div class="label">
  <div style="font-size:10px;color:#999;margin-bottom:4px">DEMO ONLY · 非真实物流面单</div>
  <div style="font-size:11px;color:#666">WP 演示物流 · 样例包裹贴</div>
  <div style="font-size:16px;font-weight:bold;margin:6px 0">收件人（虚构）：陈晓雯</div>
  <div style="font-size:12px">浙江省杭州市滨江区网商路 520 号</div>
  <div style="margin-top:8px;font-size:20px;font-weight:bold;letter-spacing:2px">包裹编号 WP-${n}</div>
  </div>
</body>
</html>`;

await webPrintPdf.printHtml(labelHtml('DEMO-001'), {
  width: labelWidth,
  height: labelHeight,
  margin: { top: '0', bottom: '0', left: '0', right: '0' }
}, {
  // 实际打印：须指定当前打印机上的物理纸张（名称以 getPrinterPapers 返回为准）
  paperFormat: '100x80'
});

返回在线样例列表

左侧浏览样例目录，右侧查看版式预览与示例代码；点击运行即可通过 web-print-pdf 驱动本地客户端完成静默打印或 PDF 预览。使用前请先安装并启动客户端。

客户端

若打印或预览效果与预期不符，请务必先从官网下载并安装最新版 Web打印专家客户端后再试（旧版本可能导致版式偏差）。

版式说明

版式预览与打印输出完全遵循 HTML/CSS 标准样式，没有隐藏的渲染技巧：样式写成什么样，页面就长成什么样。

12 - 自定义纸张尺寸

示例代码

const labelWidth = '100mm';
const labelHeight = '80mm';

const labelHtml = (n) => `<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <style>
    html, body { margin: 0; padding: 0; }
    .label {
      width: ${labelWidth};
      height: ${labelHeight};
      border: 1px solid #333;
      padding: 8mm;
      font-family: Arial, sans-serif;
      box-sizing: border-box;
    }
  </style>
</head>
<body>
  <div class="label">
  <div style="font-size:10px;color:#999;margin-bottom:4px">DEMO ONLY · 非真实物流面单</div>
  <div style="font-size:11px;color:#666">WP 演示物流 · 样例包裹贴</div>
  <div style="font-size:16px;font-weight:bold;margin:6px 0">收件人（虚构）：陈晓雯</div>
  <div style="font-size:12px">浙江省杭州市滨江区网商路 520 号</div>
  <div style="margin-top:8px;font-size:20px;font-weight:bold;letter-spacing:2px">包裹编号 WP-${n}</div>
  </div>
</body>
</html>`;

await webPrintPdf.printHtml(labelHtml('DEMO-001'), {
  width: labelWidth,
  height: labelHeight,
  margin: { top: '0', bottom: '0', left: '0', right: '0' }
}, {
  // 实际打印：须指定当前打印机上的物理纸张（名称以 getPrinterPapers 返回为准）
  paperFormat: '100x80'
});

运行结果

样例优先加载本站内置 web-print-pdf，与 npm 包 API 一致；失败时回退 CDN。
客户端内置「运行示例」页（vueApp/.../examples/index.vue）提供更多可编辑 demo，与本页样例互补。
工具类样例（连接检测、打印机列表等）仅返回 JSON，不触发打印。

免费下载客户端查看 npm 包