vue-quokit 0.1.3 → 0.1.5

package/README.md

@@ -158,6 +158,37 @@ const colsState = useColumns([
 | `exportExcel(expandRowHeight?)` | 导出 `.xlsx`，可选撑长模式 |
 | `print(vertical?)` | 打印，可选竖版 |
 
+### `<QuokitPreview>`
+
+一键弹出预览弹窗，内置导出 Excel / 打印 / 查看 JSON 按钮组。
+
+| prop | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `tpl` | `QuokitTemplateData` | — | **必填**，模板对象 |
+| `data` | `Object` | `{ headerData: {}, rows: [], footerData: {} }` | 数据对象 |
+| `config` | `Object` | 见下 | 控制按钮显示 |
+
+**config 字段：**
+
+| 字段 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `title` | `string` | `'👁️ 总体预览'` | 弹窗标题 |
+| `excel` | `boolean` | `true` | 显示两个导出 Excel 按钮（普通 / 撑长） |
+| `print` | `boolean` | `true` | 显示两个打印按钮（横版 / 竖版） |
+| `json` | `boolean` | `true` | 显示两个 JSON 按钮（模板 / 数据） |
+
+**Events：** `close` — 用户关闭弹窗时触发
+
+### `openPreviewStatic(tpl, data?, config?)`
+
+命令式调用，一行代码弹出预览。自动挂载到 `document.body`，关闭时自动卸载。
+
+```js
+import { openPreviewStatic } from 'vue-quokit';
+
+openPreviewStatic(tpl, data, { excel: true, print: false, json: false });
+```
+
 ### Composables
 
 #### `useColumns(initialColumns?, initialGroupRules?)`
@@ -213,6 +244,8 @@ src/components/vue-quokit/
 │   │   └── schema.js
 │   └── preview/                 ← 渲染域
 │       ├── QuokitSheet.vue
+│       ├── QuokitPreview.vue
+│       ├── usePreview.js
 │       └── mockData.js
 │
 ├── shared/                     ← 跨域共享