vg-print 1.1.317 → 1.1.319

package/README.md

@@ -1007,7 +1007,7 @@ const preview = async () => {
   await nextTick() // 等容器渲染出来
 
   const tpl = createTemplate(tmplJson)
-  const html = getHtml(tpl, printData) // 始终为字符串
+  const html = await getHtml(tpl, printData) // 建议始终 await（兼容 beforeGetHtml 返回 Promise）
 
   const container = document.getElementById('preview_content_custom') // 显示内容的div的id
   if (!container) {
@@ -1017,6 +1017,45 @@ const preview = async () => {
   container.innerHTML = html
 }
 
+#### beforeGetHtml（获取 HTML 前处理）
+
+用于在生成 HTML 后、返回/打印/直连发送前，对 HTML 字符串做二次处理；支持返回 Promise。
+
+回调签名：
+
+```js
+beforeGetHtml: ({ template, html }) => html
+```
+
+- `template`：当前 `hiprint.PrintTemplate` 实例
+- `html`：生成的 HTML 字符串（可返回新字符串替换；返回 `undefined/null` 则保持不变）
+
+示例：
+
+```js
+const tpl = createTemplate(tmplJson)
+
+const html = await getHtml(tpl, printData, {
+  beforeGetHtml: async ({ template, html }) => {
+    return html
+  }
+})
+
+await tpl.getHtml(printData, {
+  beforeGetHtml: ({ template, html }) => html
+})
+
+printBrowser(tpl, printData, {
+  beforeGetHtml: ({ template, html }) => html
+})
+
+tpl.print2(printData, {
+  printer: printers?.[0]?.name || '',
+  title: '打印预览pdf',
+  beforeGetHtml: ({ template, html }) => html
+})
+```
+
 // 3) 浏览器打印（不需要客户端）
 printBrowser(tpl, printData)
 
@@ -1347,3 +1386,19 @@ const onSave = ({ template, data, templateId }) => {
 }
 </script>
 ```
+
+## License
+
+LGPL
+
+### 开源使用须知
+
+1. 请自觉遵守 LGPL 协议，其他用途可联系作者；
+
+2. 允许用于个人学习、毕业设计、教学案例、公益事业、商业使用；
+
+3. 如果商用必须保留版权信息，请自觉遵守；
+
+4. 禁止将本开源的代码和资源进行任何形式任何名义的出售，否则产生的一切任何后果责任由侵权者自负；
+
+5. 商用请仔细审查代码和漏洞，不得用于任一国家许可范围之外的商业应用，产生的一切任何后果责任自负；

package/dist/css/print-lock.css

@@ -1,5 +1,13 @@
 
 @media print {
+    /* Cancel the designer viewport rule when this file is loaded by the
+       browser-print iframe. */
+    html,
+    body {
+        height: auto !important;
+        min-height: 0 !important;
+        overflow: visible !important;
+    }
     body {
         margin: 0px;
         padding: 0px;
@@ -29,6 +37,8 @@
     position: relative;
     padding: 0 0 0 0;
     page-break-after: always;
+    break-after: page;
+    break-inside: avoid;
     -webkit-user-select: none; /* Chrome/Safari/Opera */
     -moz-user-select: none; /* Firefox */
     user-select: none;