vg-print-vue2 1.0.607 → 1.0.609

package/README.md

@@ -252,6 +252,17 @@ hiprint.register({
 
 不传参数则使用插件内置的默认列表；你也可以按 `{ title, value, group }` 的结构传入完整的分组列表（`group: true` 表示分组标题）。
 
+## HTML 导出
+
+Header 保存菜单和 Preview 预览工具栏中的“导出 HTML”由本项目内的 `src/utils/htmlExport.js` 实现，不需要额外安装或注册插件。FullDesigner 和 Preview 都会把当前模板及打印数据交给本地工具，生成并下载完整 HTML 文档，同时返回 Blob。文档会恢复页面滚动，保留多面板布局并复制页面样式；CSS 图片、字体等相对地址会按原样式表地址解析。外部资源仍需能从导出文件所在环境访问。
+
+可通过 FullDesigner 实例调用：
+
+```js
+await this.$refs.designer.toHtml()
+```
+
+Header / FullDesigner 可通过 `showHtml` / `show-option.showHtml` 控制菜单项显示。
 ## Header 顶部工具栏组件
 
 - 用于页面一级头部区域，内置常用操作按钮；支持通过 `props` 与 `slots` 定制。
@@ -273,16 +284,17 @@ hiprint.register({
 | `showPrintView` | 浏览器打印 |
 | `showPdf` | 导出 PDF；还需已注册 PDF 插件 |
 | `showImage` | 导出图片 |
-| `showClientGenerate` | 客户端生成 |
+| `showHtml` | 导出 HTML |
+| `showClientGenerate` | 客户端生成；独立按钮，客户端未连接时禁用 |
 | `showSave` | 整个保存按钮组，包括下拉菜单 |
 | `showSaveMenu` | 保存下拉入口及菜单，保留保存主按钮 |
 | `showEditTemplate` | 下拉菜单中的编辑模板数据 |
 | `showEditData` | 下拉菜单中的编辑打印数据 |
 | `showExportTemplate` | 下拉菜单中的导出模板 |
 | `showImportTemplate` | 下拉菜单中的导入模板 |
-| `showFeedback` | 反馈 |
+| `showFeedback` | 保存下拉菜单中的反馈 |
 
-四个下拉菜单项全部关闭时自动隐藏下拉入口。显示配置控制默认按钮，使用方在插槽内创建的按钮由使用方自行控制。
+除“新建”、“模板中心”和“客户端生成”外，默认操作按钮位于保存下拉菜单中；客户端未连接时“客户端生成”按钮会禁用。单独使用 Header 时可通过 `clientConnected` 属性传入连接状态，默认 `false`。所有菜单项都隐藏时自动隐藏下拉入口；`showSaveMenu: false` 会隐藏下拉入口及其中的操作，保存主按钮仍可独立显示。显示配置控制默认按钮，使用方在插槽内创建的按钮由使用方自行控制。
 
 ### 事件（Emits）
 
@@ -291,6 +303,7 @@ hiprint.register({
 - `print-view` 浏览器打印
 - `to-pdf` 导出 PDF
 - `to-image` 导出图片
+- `to-html` 导出 HTML
 - `clear-paper` 清空（带二次确认）
 - `save` 保存（拆分按钮的主键）
 - `edit-template` 打开“编辑模板数据”对话框
@@ -513,10 +526,12 @@ export default {
 - `dialogTitleHtml: string` 弹窗标题 HTML 内容，默认 `''`（支持 \`弹窗标题）
 - `showTitle: boolean` 是否显示标题，默认 `true`
 - `showPdf: boolean` 是否显示“导出 PDF”按钮，默认 `true`
+- `showHtml: boolean` 是否显示“导出 HTML”按钮，默认 `true`；可用 `show({ showHtml })` 单次覆盖
 - `showImg: boolean` 是否显示“导出图片”按钮，默认 `true`
 - `showPrint2: boolean` 是否显示“直接打印”按钮，默认 `true`
 - `pdfOptions: object` 导出 PDF 选项（参考 `toPdf`）
 - `imageOptions: object` 导出图片 选项（参考 `toImage`）
+- `htmlOptions: object` 本次 HTML 文件名、标题及样式选项
 - `directPrintOptions: object` 直接打印 选项（参考 `print`）
 - `browserPrintOptions: object` 浏览器打印 选项（参考 `printView`）
 - `showPrinterSelect: boolean` 是否显示“打印机选择”下拉区域，默认 `true`
@@ -597,6 +612,7 @@ export default {
         dialogTitleHtml: '<h2>自定义预览标题</h2>',
         showTitle: false,
         showPdf: false,
+        showHtml: true,
         showImg: false,
         showPrint2: false,
         showPrinterSelect: false,
@@ -743,7 +759,7 @@ Vue 2 的完整接入案例、按需加载、刷新、ID 回填、客户端联
   - `showToolbar: boolean` 是否显示二级工具栏 Toolbar，默认 `true`
   - `showFooter: boolean` 是否显示底部 Footer，默认 `true`
   - `showTemplateLibrary: boolean` 是否显示头部模板中心按钮，默认 `true`；动态关闭时关闭模板中心弹窗，不影响模板加载和保存功能
-- `show-option` 同时支持上方 Header 配置表中的所有按钮显示项：`showPreview`、`showPrintView`、`showPdf`、`showImage`、`showClientGenerate`、`showSave`、`showSaveMenu`、`showEditTemplate`、`showEditData`、`showExportTemplate`、`showImportTemplate`、`showFeedback`；均默认 `true`，支持动态修改
+- `show-option` 同时支持上方 Header 配置表中的所有按钮显示项：`showPreview`、`showPrintView`、`showPdf`、`showHtml`、`showImage`、`showClientGenerate`、`showSave`、`showSaveMenu`、`showEditTemplate`、`showEditData`、`showExportTemplate`、`showImportTemplate`、`showFeedback`；均默认 `true`，支持动态修改
 - `footer-text: string` 底部默认文案（仅在未提供 `#footer` 插槽时展示）
 
 以上属性支持运行时动态修改；组件内部已监听并应用。