vg-print 1.1.502 → 1.1.505

package/README.md

@@ -197,7 +197,7 @@ hiprint.register({
 - `save` 保存（拆分按钮的主键）
 - `edit-template` 打开“编辑模板数据”对话框
 - `edit-data` 打开“编辑打印数据”对话框
-- `lang-change` 语言切换（值为语言码：`cn`、`en`、`de`、`es`、`fr`、`it`、`ja`、`ru`、`cn_tw`）
+- `lang-change` 语言切换（值为语言码：`cn`、`en`、`cn_tw`）
 - `feedback` 反馈/帮助
 
 ### 插槽（Slots）
@@ -331,7 +331,7 @@ const onSaveDirect = () => designer.value?.save()
 - `showPrinterSelect: boolean` 是否显示“打印机选择”下拉区域，默认 `true`
 - `modalShow: boolean` 弹窗显隐（支持 `v-model:modalShow`）
 - `width: string | number` 弹窗宽度（默认 `'80%'`）
-- `defaultLang: string` 组件内 i18n 语言（Standalone 时使用）；支持 `cn`、`en`、`de`、`es`、`fr`、`it`、`ja`、`ru`、`cn_tw`；默认 `cn`
+- `defaultLang: string` 组件内 i18n 语言（Standalone 时使用）；支持 `cn`、`en`、`cn_tw`；默认 `cn`
 
 预览头部标题使用
 
@@ -522,10 +522,10 @@ import 'vg-print/style.css'
 - `hi-host: string` 客户端服务地址；示例 `http://127.0.0.1:17521`，用于直连打印
 - `hi-token: string` 客户端鉴权令牌；与客户端配置一致时方可直连打印
 - `hi-auto-connect: boolean` 是否自动连接客户端；默认 `true`，为 `false` 时需手动调用 `connect()`
-- `initial-template: object` 初始化模板 JSON；为空时使用内置示例模板
+- `initial-template: object` 初始化模板 JSON；组件会先完成设计器页面的首次渲染，再将模板数据加载进去；为空时使用内置示例模板
 - `initial-print-data: object | array` 初始化打印数据；支持对象或数组，运行时变更会即时生效
 - `data-sources: Array | object` 外部传入的数据源字段元数据；支持直接传入字段列表、表结构字段列表或带 `dataSets`/`fields` 的完整结构，用于设计器字段选择器；不传时继续使用数据源配置中的请求方式
-- `default-lang: string` 默认语言；支持 `cn`、`en`、`de`、`es`、`fr`、`it`、`ja`、`ru`、`cn_tw`；默认 `cn`
+- `default-lang: string` 默认语言；支持 `cn`、`en`、`cn_tw`；默认 `cn`
 - `config: object` 设计器引擎配置；会在初始化前注入到 `hiprint.setConfig(config)`（同时写入 `window.HIPRINT_CONFIG`）。常用字段：
   - `showAdsorbLine: boolean` 是否显示吸附参考线（拖动/缩放时的对齐辅助线）
   - `showPosition: boolean` 是否显示元素坐标提示（移动元素时显示位置）
@@ -620,18 +620,6 @@ import 'vg-print/style.css'
 - `disconnect()` 断开客户端连接
 - `disAutoConnect()` 关闭自动连接策略；阻止自动重连
 
-### 事件（Emits，含描述）
-
-- `save` 保存模板与数据；回调参数结构：
-
-```js
-{
-  template,   // 模板 JSON
-  data,       // 当前打印数据（对象或数组）
-  templateId  // 模板标识（若存在）
-}
-```
-
 示例：
 
 ```vue
@@ -641,14 +629,30 @@ import 'vg-print/style.css'
     :initial-print-data="rows"
     default-lang="cn"
     @save="onSave"
+    @onDesigned="onDesigned"
   />
 </template>
 
 <script setup>
+/*  保存方法
+  template,   // 模板 JSON
+  data,       // 当前打印数据（对象或数组）
+  templateId  // 模板标识（若存在）
+*/
 const onSave = ({ template, data, templateId }) => {
   // 调用接口持久化到数据库
   // await api.saveTemplate({ template, data, templateId })
 }
+/*  设计器渲染完成后执行自定义逻辑
+  designer,    // hiprint.PrintTemplate 实例
+  template,    // 当前模板 JSON
+  source       // initial / incoming / library / json
+*/
+const onDesigned = ({ designer, template, source }) => {
+  // 设计器页面与初始模板已经完成加载
+  console.log(source, designer, template)
+  // 也可以在这里继续调用 designer.update(...) 或其他设计器方法
+}
 </script>
 ```