vg-print-vue2 1.0.210 → 1.0.301

package/README.en.md

@@ -33,6 +33,21 @@ https://download.csdn.net/download/github_38400706/92538739
 npm i vg-print-vue2
 ```
 
+If you need client direct printing (`hiwebSocket`), install the optional dependency in your host app:
+
+```bash
+npm i socket.io-client
+```
+
+In your main entry file (e.g., `main.ts`):
+
+```js
+import { io } from 'socket.io-client'
+import { setSocketIo } from 'vg-print'
+
+setSocketIo(io)
+```
+
 ## Header Component
 
 - Used for the top area of the page, with built-in common operation buttons and printer settings; supports customization via `props` and `slots`.
@@ -372,9 +387,9 @@ new Vue({
 - `printView()` Browser print
 - `print()` Direct print
 - `toPdf()` Export PDF
-- `toPdf2()` Export PDF with paper layout
+- `toPdf()` Export PDF with paper layout
 - `toImage()` Export Image
-- `toImage2()` Export Image with paper layout
+- `toImage()` Export Image with paper layout
 - `toImage()` Export Image
 - `setHiwebSocket(host, token, cb)` Set client address/token (Respects autoConnect state)
 - `setHost(host, token, cb)` Set client address/token and connect immediately (Standard API)
@@ -437,10 +452,7 @@ exportPdf(tpl, printData, 'filename')
 `exportPdf` / `exportImage` are lightweight wrappers around the template instance methods:
 
 - `exportPdf(tpl, data, filename, options)` → `tpl.toPdf(data, filename, options)`
-- `exportPdf2(tpl, data, filename, options)` → `tpl.toPdf2(data, filename, options)`
-
 - `exportImage(tpl, data, options)` → `tpl.toImage(data, options)`
-- `exportImage2(tpl, data, options)` → `tpl.toImage2(data, options)`
 
 #### Export PDF
 

package/README.md

@@ -109,6 +109,25 @@ hiprint.register({
 ```bash
 npm i vg-print-vue2
 ```
+### 可选依赖：直连打印/客户端连接（socket.io-client）
+
+- 本库默认不内置 `socket.io-client`，以减少默认安装体积。
+- 仅当你需要“直连打印/客户端连接（hiwebSocket）”能力（如 `print()` / `print2()` / 自动连接）时，才需要安装并注入：
+
+```bash
+npm i socket.io-client
+```
+
+在项目入口（如 `main.ts`）注入：
+
+```js
+import { io } from 'socket.io-client'
+import { setSocketIo } from 'vg-print'
+
+setSocketIo(io)
+```
+
+也可直接使用 `window.io = io`（等价）。
 
 ## Header 顶部工具栏组件
 
@@ -680,10 +699,8 @@ export default {
 - `preView()` 打开预览弹窗；将当前模板与数据渲染为预览 HTML
 - `printView()` 浏览器打印；不依赖客户端，调起系统打印对话框
 - `print()` 直接打印；需客户端已连接，按当前选定打印机输出
-- `toPdf()` 导出 PDF；使用内置 A4 排版示例参数导出
-- `toPdf2()` 导出 PDF；支持自定义参数，如缩放比例、页边距等(通过@zumer/snapdom库插件)
-- `toImage()` 导出图片；使用内置 A4 排版示例参数导出
-- `toImage2()` 导出图片；支持自定义参数，如缩放比例、页边距等(通过@zumer/snapdom库插件)
+- `toPdf()` 导出 PDF；当前统一使用 `@zumer/snapdom` 渲染，支持缩放比例、页边距等参数
+- `toImage()` 导出图片；当前统一使用 `@zumer/snapdom` 渲染，支持缩放比例、页边距等参数
 
 - `setHiwebSocket(host: string, token?: string, cb?: Function)` 设置客户端地址与令牌并尝试重连；`cb(status, msg)` 为连接回调
 - `connect(cb?: Function)` 主动连接客户端；`cb(status, msg)` 为连接回调
@@ -878,8 +895,8 @@ tpl.toPdf(this.printDataVar, '打印预览pdf', {
     }
   }
 });
-// 这是使用@zumer/snapdom库插件导出PDF的示例，使用方式和toPdf一样
-tpl.toPdf2(this.printDataVar, '打印预览pdf', {
+// 当前 toPdf 内部统一使用 @zumer/snapdom 导出 PDF
+tpl.toPdf(this.printDataVar, '打印预览pdf', {
   onProgress: (cur, total) => { 
     // 导出进度100%的时候关闭等待
     if (cur === total) {
@@ -924,8 +941,8 @@ tpl.toImage(this.printDataVar, {
   }
 })
 
-// 这是使用@zumer/snapdom库插件导出图片的示例，使用方式和oImage一样
-tpl.toImage2(this.printDataVar, {
+// 当前 toImage 内部统一使用 @zumer/snapdom 导出图片
+tpl.toImage(this.printDataVar, {
   paperWidth: 210,
   paperHeight: 297,
   limit: 6,
@@ -955,9 +972,7 @@ import {
   getHtml,
   printBrowser,
   exportPdf,
-  exportPdf2,
   exportImage,
-  exportImage2,
   getPrinterList,
   refreshPrinterList,
   getAddress,
@@ -1020,7 +1035,7 @@ exportPdf(tpl, printData, '打印预览pdf', {
 })
 
 // 插件方法
-exportPdf2(tpl, printData, '打印预览pdf', {
+exportPdf(tpl, printData, '打印预览pdf', {
   paperWidth: 210, 
   paperHeight: 297, 
   perPage: 6, 
@@ -1052,7 +1067,7 @@ await exportImage(tpl, printData, {
 })
 
 // 插件方法
-exportImage2(tpl, printData, {
+exportImage(tpl, printData, {
   paperWidth: 210,
   paperHeight: 297,
   limit: 6,
@@ -1125,14 +1140,9 @@ disconnect()
 - 适用：报告类、A4/A5 正常分页模板。
 
 ```js
-// 不传 paperWidth/paperHeight，使用模板的面板尺寸与分页配置
 exportPdf(tpl, printData, '打印预览pdf', {
   onProgress: (cur, total) => console.log('toPdf 进度', Math.floor((cur / total) * 100))
 })
-
-exportPdf2(tpl, printData, '打印预览pdf', {
-  onProgress: (cur, total) => console.log('toPdf 进度', Math.floor((cur / total) * 100))
-})
 ```
 
 #### 模式 B：排版导出（把小模板拼到大纸张，例如 A4）
@@ -1155,20 +1165,6 @@ exportPdf(tpl, printData, '打印预览pdf', {
   imageCompression: 'FAST', // 图片压缩算法 默认 FAST 支持 FAST、MEDIUM、SLOW
   onProgress: (cur, total) => console.log('toPdf 进度', Math.floor((cur / total) * 100))
 })
-
-exportPdf2(tpl, printData, '打印预览pdf', {
-  paperWidth: 210,      // mm
-  paperHeight: 297,     // mm
-  perPage: 6,           // 每页放 6 个（不够的到下一页）
-  leftOffset: -1,       // -1 表示水平居中；>=0 表示左边距 mm
-  topOffset: -1,        // -1 表示垂直居中；>=0 表示上边距 mm
-  scale: 1,             // 清晰度/性能权衡（也可用 pixelRatio）
-  pdfCompress: true, // 是否压缩PDF 默认 true
-  imageType: 'JPEG', // 图片类型 默认 JPEG 支持 JPEG、PNG
-  imageQuality: 0.92, // 图片质量 0-1 默认 0.92
-  imageCompression: 'FAST', // 图片压缩算法 默认 FAST 支持 FAST、MEDIUM、SLOW
-  onProgress: (cur, total) => console.log('toPdf 进度', Math.floor((cur / total) * 100))
-})
 ```
 
 #### 排版规则（重点：perPage=0/不传的行为）