vg-print 1.0.216 → 1.0.217

package/README.md

@@ -90,6 +90,9 @@ const disableAutoConnect = () => designer.value.disAutoConnect()
 - `hi-host: string` 客户端服务地址（`hiwebSocket.host`），如 `http://127.0.0.1:17521`
 - `hi-token: string` 客户端鉴权令牌（`hiwebSocket.token`）
 - `hi-auto-connect: boolean` 是否自动连接客户端，默认 `true`
+- `initial-template: object` 初始化模板 JSON（为空则使用内置示例）
+- `initial-print-data: object | array` 初始化打印数据（对象或数组）
+- `default-lang: string` 默认语言（`cn`、`en`、`de` 等；默认 `cn`）
 
 以上属性支持运行时动态修改，组件内部会监听并应用。
 
@@ -105,6 +108,49 @@ const disableAutoConnect = () => designer.value.disAutoConnect()
 - `disconnect()` 断开客户端
 - `disAutoConnect()` 关闭自动连接策略
 
+### 事件（Emits）
+
+- `save` 保存模板与数据。回调参数结构：
+
+```js
+{
+  template,   // 模板 JSON
+  data,       // 当前打印数据（对象或数组）
+  templateId  // 模板标识（若存在）
+}
+```
+
+示例：
+
+```vue
+<template>
+  <FullDesigner
+    :initial-template="tpl"
+    :initial-print-data="rows"
+    default-lang="cn"
+    @save="onSave"
+  />
+</template>
+
+<script setup>
+const onSave = ({ template, data, templateId }) => {
+  // 调用接口持久化到数据库
+  // await api.saveTemplate({ template, data, templateId })
+}
+</script>
+```
+
+### 快捷键
+
+- 保存：`Ctrl/Command + S`
+- 编辑模板 JSON：`Ctrl/Command + E`
+- 编辑打印数据：`Ctrl/Command + Shift + E`
+
+### 语言与国际化
+
+- 通过 `default-lang` 设置初始语言（`cn` 默认为中文）；内部会同步 `vue-i18n` 与 `hiprint` 的语言。
+- 运行时可在页面右上角语言切换菜单切换（无需刷新）。
+
 ## 高级用法（hiprint）
 
 本库导出 `hiprint`，可直接创建与操作模板对象（`hiprint.PrintTemplate`）：
@@ -136,6 +182,7 @@ tpl.toImage({ name: '示例' }, { isDownload: true, name: '图片', limit: 1, ty
 - 建议在 `index.html` 注入 `print-lock.css`，保证打印样式稳定
 - 直接打印需配套客户端（Electron 或服务端），跨域部署需启用 HTTPS
 - 若使用自定义 `host/token`，确保客户端配置一致且网络可达
+- SSR 兼容：插件安装仅在浏览器环境执行（`typeof window !== 'undefined'`），在 SSR 框架中引入不会因 `window` 未定义报错。
 
 ## 构建