vg-print 1.1.0 → 1.1.2

package/README.md

@@ -550,6 +550,88 @@ const onSave = ({ template, data, templateId }) => {
 - 通过 `default-lang` 设置初始语言（`cn` 默认为中文）；内部会同步 `vue-i18n` 与 `hiprint` 的语言。
 - 运行时可在页面右上角语言切换菜单切换（无需刷新）。
 
+## 数据源使用说明
+
+`FullDesigner` 内置了数据源管理与字段绑定能力，可用于将接口字段自动映射到设计器组件字段下拉中。
+
+### 入口与能力
+
+- 入口：二级工具栏点击“数据源”打开管理弹窗
+- 能力：数据源配置、测试获取、数据处理脚本、错误处理脚本、字段来源规则（全局/按组件类型）
+
+### 使用流程（推荐）
+
+1. 新增数据源并填写基础信息：
+   - 唯一名称
+   - 请求地址（URL）
+   - 请求方法（GET/POST/PUT/DELETE）
+2. 按需配置请求头、参数、发送数据：
+   - 类型支持：`string`、`number`、`boolean`、`expression`
+3. 编写“数据处理”脚本（`processCode`）并点击“测试链接”：
+   - 左侧显示原始返回（`rawResult`）
+   - 右侧显示处理结果（`processed`）
+4. 配置“字段来源规则”并保存：
+   - 看板全局：`manual` 或 `global`
+   - 组件规则：`manual` / `global` / `custom`
+5. 规则生效后，组件字段下拉会按规则自动展示字段列表
+
+### processCode / errorProcessCode 约定
+
+- `processCode` 函数形态：
+
+```js
+// (result, isSandbox, DSV, VFR) => { ...; return processed; }
+return result
+```
+
+- `errorProcessCode` 函数形态：
+
+```js
+// (error, isSandbox, DSV, $message, VFR) => { ... }
+$message.error(error.message)
+```
+
+### 字段结构约定
+
+推荐返回以下结构，字段下拉识别最稳定：
+
+```js
+[
+  { text: '字段显示名', field: '字段路径' }
+]
+```
+
+如果返回的是对象或对象数组，系统也会自动递归提取字段路径（如 `user.name`、`order.items`）。
+
+### 示例：将接口返回转换为字段列表
+
+```js
+return (result.data || []).map(item => ({
+  field: item.column_name,
+  text: item.table_comment || item.column_name
+}))
+```
+
+### 缓存与持久化策略（当前实现）
+
+- 数据源配置持久化：`KEY_VG_DATASOURCES`
+- 字段绑定规则持久化：`KEY_VG_FIELD_BINDINGS`
+- 数据源运行时缓存：`KEY_VG_DS_RUNTIME_CACHE`
+  - 仅缓存处理后数据（`processed`）
+  - 不缓存原始返回（`rawResult`）
+  - 默认 TTL：30 分钟
+  - 默认最大条目：20
+
+### 常见问题
+
+- 测试成功但没有字段：
+  - 检查 `processCode` 返回值是否为对象或对象数组
+  - 检查数据集 path 是否命中处理结果
+- 字段下拉未更新：
+  - 先“测试链接”生成字段，再“保存规则”
+- 表达式参数无效：
+  - `expression` 求值异常会被忽略，建议先用简单表达式验证
+
 ## 高级用法（hiprint）
 
 本库导出 `hiprint`，可直接创建与操作模板对象（`hiprint.PrintTemplate`）：

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vg-print",
   "description": "vg-print Vue3.x 支持拖拽(分页(不分页)、表头表脚、样式设置、复制粘贴、缩放、撤销重做)生成打印模板、导出json模板数据、静默打印/获取MAC地址(借助客户端)",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "author": "gmcSimple",
   "license": "MIT",
   "main": "dist/vg-print.es.js",

package/dist/chunk-MW6X4KTL-BGX4AdvZ.js

@@ -1,87 +0,0 @@
-import { l as b } from "./index-CFsMCiM-.js";
-function M(e) {
-  return typeof e == "string" && /^data:image\/svg\+xml/i.test(e);
-}
-function C(e) {
-  let r = e.indexOf(",");
-  return r >= 0 ? decodeURIComponent(e.slice(r + 1)) : "";
-}
-function v(e) {
-  return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(e)}`;
-}
-function F(e) {
-  let r = [], t = "", i = 0;
-  for (let o = 0; o < e.length; o++) {
-    let n = e[o];
-    n === "(" && i++, n === ")" && (i = Math.max(0, i - 1)), n === ";" && i === 0 ? (r.push(t), t = "") : t += n;
-  }
-  return t.trim() && r.push(t), r.map((o) => o.trim()).filter(Boolean);
-}
-function k(e) {
-  let r = [], t = "", i = 0;
-  for (let n = 0; n < e.length; n++) {
-    let s = e[n];
-    s === "(" && i++, s === ")" && (i = Math.max(0, i - 1)), s === "," && i === 0 ? (r.push(t.trim()), t = "") : t += s;
-  }
-  t.trim() && r.push(t.trim());
-  let o = [];
-  for (let n of r) {
-    if (/\binset\b/i.test(n)) continue;
-    let s = n.match(/-?\d+(?:\.\d+)?px/gi) || [], [l = "0px", a = "0px", m = "0px"] = s, u = n.replace(/-?\d+(?:\.\d+)?px/gi, "").replace(/\binset\b/ig, "").trim().replace(/\s{2,}/g, " "), d = !!u && u !== ",";
-    o.push(`drop-shadow(${l} ${a} ${m}${d ? ` ${u}` : ""})`);
-  }
-  return o.join(" ");
-}
-function y(e) {
-  let r = F(e), t = null, i = null, o = null, n = [];
-  for (let l of r) {
-    let a = l.indexOf(":");
-    if (a < 0) continue;
-    let m = l.slice(0, a).trim().toLowerCase(), u = l.slice(a + 1).trim();
-    m === "box-shadow" ? o = u : m === "filter" ? t = u : m === "-webkit-filter" ? i = u : n.push([m, u]);
-  }
-  if (o) {
-    let l = k(o);
-    l && (t = t ? `${t} ${l}` : l, i = i ? `${i} ${l}` : l);
-  }
-  let s = [...n];
-  return t && s.push(["filter", t]), i && s.push(["-webkit-filter", i]), s.map(([l, a]) => `${l}:${a}`).join(";");
-}
-function I(e) {
-  return e.replace(/([^{}]+)\{([^}]*)\}/g, (r, t, i) => `${t}{${y(i)}}`);
-}
-function N(e) {
-  return e = e.replace(/<style[^>]*>([\s\S]*?)<\/style>/gi, (r, t) => r.replace(t, I(t))), e = e.replace(/style=(['"])([\s\S]*?)\1/gi, (r, t, i) => `style=${t}${y(i)}${t}`), e;
-}
-function S(e) {
-  if (!b() || !M(e)) return e;
-  try {
-    let r = C(e), t = N(r);
-    return v(t);
-  } catch {
-    return e;
-  }
-}
-async function R(e, r) {
-  let { width: t, height: i, scale: o = 1, dpr: n = 1, meta: s = {}, backgroundColor: l } = r;
-  e = S(e);
-  let a = new Image();
-  a.loading = "eager", a.decoding = "sync", a.crossOrigin = "anonymous", a.src = e, await a.decode();
-  let m = a.naturalWidth, u = a.naturalHeight, d = Number.isFinite(s.w0) ? s.w0 : m, x = Number.isFinite(s.h0) ? s.h0 : u, c, f, $ = Number.isFinite(t), w = Number.isFinite(i);
-  if ($ && w) c = Math.max(1, t), f = Math.max(1, i);
-  else if ($) {
-    let g = t / Math.max(1, d);
-    c = t, f = x * g;
-  } else if (w) {
-    let g = i / Math.max(1, x);
-    f = i, c = d * g;
-  } else c = m, f = u;
-  c = c * o, f = f * o;
-  let h = document.createElement("canvas");
-  h.width = c * n, h.height = f * n, h.style.width = `${c}px`, h.style.height = `${f}px`;
-  let p = h.getContext("2d");
-  return n !== 1 && p.scale(n, n), l && (p.save(), p.fillStyle = l, p.fillRect(0, 0, c, f), p.restore()), p.drawImage(a, 0, 0, c, f), h;
-}
-export {
-  R as W
-};

package/dist/chunk-Q2Z2CG2I-4zALoFop.js

@@ -1,8 +0,0 @@
-import { W as a } from "./chunk-MW6X4KTL-BGX4AdvZ.js";
-async function o(r, t) {
-  let i = await a(r, t), e = new Image();
-  return e.src = i.toDataURL(`image/${t.format}`, t.quality), await e.decode(), e.style.width = `${i.width / t.dpr}px`, e.style.height = `${i.height / t.dpr}px`, e;
-}
-export {
-  o as d
-};

package/dist/chunk-Y7FY32AO-CBomeJj8.js

@@ -1,13 +0,0 @@
-import { W as m } from "./chunk-MW6X4KTL-BGX4AdvZ.js";
-async function a(n, e) {
-  let o = e.type;
-  if (o === "svg") {
-    let t = decodeURIComponent(n.split(",")[1]);
-    return new Blob([t], { type: "image/svg+xml" });
-  }
-  let i = await m(n, e);
-  return new Promise((t) => i.toBlob((l) => t(l), `image/${o}`, e.quality));
-}
-export {
-  a as m
-};

package/dist/css/print-lock.css

@@ -1,297 +0,0 @@
-
-@media print {
-    body {
-        margin: 0px;
-        padding: 0px;
-    }
-}
-
-@page {
-    margin: 0;
-}
-
-.hiprint-printPaper * {
-    box-sizing: border-box;
-    -moz-box-sizing: border-box; /* Firefox */
-    -webkit-box-sizing: border-box; /* Safari */
-    image-rendering: -webkit-optimize-contrast; /* 让图片/标尺稍微清楚一点 */
-}
-
-    .hiprint-printPaper *:focus {
-        outline: -webkit-focus-ring-color auto 0px;
-    }
-
-
-.hiprint-page-break-avoid {
-    page-break-after: avoid;
-}
-.hiprint-printPaper {
-    position: relative;
-    padding: 0 0 0 0;
-    page-break-after: always;
-    -webkit-user-select: none; /* Chrome/Safari/Opera */
-    -moz-user-select: none; /* Firefox */
-    user-select: none;
-    overflow-x: hidden;
-    overflow: hidden;
-}
-    .hiprint-printPaper .hiprint-printPaper-content {
-        position: relative;
-    }
-.hiprint-printPaper.design {
-    overflow: visible;
-}
-
-
-
-.hiprint-printTemplate .hiprint-printPanel {
-    page-break-after: always;
-}
-
-.hiprint-printPaper, hiprint-printPanel {
-    box-sizing: border-box;
-    border: 0px;
-}
-
-.hiprint-printPanel .hiprint-printPaper:last-child {
-    page-break-after: avoid;
-}
-
-.hiprint-printTemplate .hiprint-printPanel:last-child {
-    page-break-after: avoid;
-}
-
-.hiprint-printPaper .hideheaderLinetarget {
-    border-top: 0px dashed rgb(201, 190, 190) !important;
-}
-
-.hiprint-printPaper .hidefooterLinetarget {
-    border-top: 0px dashed rgb(201, 190, 190) !important;
-}
-
-.hiprint-printPaper.design {
-    border: 1px dashed rgba(170,170,170,0.7);
-}
-
-.design .hiprint-printElement-table-content, .design .hiprint-printElement-longText-content {
-    overflow: hidden;
-    box-sizing: border-box;
-}
-
-.design .resize-panel {
-    box-sizing: border-box;
-    border: 1px dotted;
-}
-
-.hiprint-printElement-text {
-    background-color: transparent;
-    background-repeat: repeat;
-    padding: 0 0 0 0;
-    border: 0.75pt none rgb(0,0,0);
-    direction: ltr;
-    font-family: 'SimSun';
-    font-size: 9pt;
-    font-style: normal;
-    font-weight: normal;
-    padding-bottom: 0pt;
-    padding-left: 0pt;
-    padding-right: 0pt;
-    padding-top: 0pt;
-    text-align: left;
-    text-decoration: none;
-    line-height: 9.75pt;
-    box-sizing: border-box;
-    word-wrap: break-word;
-    word-break: break-all;
-}
-
-.design .hiprint-printElement-text-content {
-    border: 1px dashed rgb(206, 188, 188);
-    box-sizing: border-box;
-}
-
-.hiprint-printElement-longText {
-    background-color: transparent;
-    background-repeat: repeat;
-    border: 0.75pt none rgb(0,0,0);
-    direction: ltr;
-    font-family: 'SimSun';
-    font-size: 9pt;
-    font-style: normal;
-    font-weight: normal;
-    padding-bottom: 0pt;
-    padding-left: 0pt;
-    padding-right: 0pt;
-    padding-top: 0pt;
-    text-align: left;
-    text-decoration: none;
-    line-height: 9.75pt;
-    box-sizing: border-box;
-    word-wrap: break-word;
-    word-break: break-all;
-    /*white-space: pre-wrap*/
-}
-
-
-
-.hiprint-printElement-table {
-    background-color: transparent;
-    background-repeat: repeat;
-    color: rgb(0,0,0);
-    border-color: rgb(0,0,0);
-    border-style: none;
-    direction: ltr;
-    font-family: 'SimSun';
-    font-size: 9pt;
-    font-style: normal;
-    font-weight: normal;
-    padding-bottom: 0pt;
-    padding-left: 0pt;
-    padding-right: 0pt;
-    padding-top: 0pt;
-    text-align: left;
-    text-decoration: none;
-    padding: 0 0 0 0;
-    box-sizing: border-box;
-    line-height: 9.75pt;
-}
-
-    .hiprint-printElement-table thead {
-        background: #e8e8e8;
-        font-weight: 700;
-    }
-
-.hiprint-printElement-tableTarget, .hiprint-printElement-tableTarget tr, .hiprint-printElement-tableTarget td {
-    border-color: rgb(0,0,0);
-    /*border-style: none;*/
-    /*border: 1px solid rgb(0,0,0);*/
-    font-weight: normal;
-    direction: ltr;
-    padding-bottom: 0pt;
-    padding-left: 4pt;
-    padding-right: 4pt;
-    padding-top: 0pt;
-    text-decoration: none;
-    vertical-align: middle;
-    box-sizing: border-box;
-    word-wrap: break-word;
-    word-break: break-all;
-    /*line-height: 9.75pt;
-    font-size: 9pt;*/
-}
-
-    /*.hiprint-printElement-tableTarget tr,*/
-    .hiprint-printElement-tableTarget td {
-        height: 18pt;
-    }
-
-/* 边框样式（用于打印时保持边框） */
-table.hiprint-printElement-tableTarget { width: 100%; }
-.hiprint-printElement-tableTarget-border-all { border: 1px solid; }
-.hiprint-printElement-tableTarget-border-none { border: 0px solid; }
-.hiprint-printElement-tableTarget-border-lr { border-left: 1px solid; border-right: 1px solid; }
-.hiprint-printElement-tableTarget-border-left { border-left: 1px solid; }
-.hiprint-printElement-tableTarget-border-right { border-right: 1px solid; }
-.hiprint-printElement-tableTarget-border-tb { border-top: 1px solid; border-bottom: 1px solid; }
-.hiprint-printElement-tableTarget-border-top { border-top: 1px solid; }
-.hiprint-printElement-tableTarget-border-bottom { border-bottom: 1px solid; }
-.hiprint-printElement-tableTarget-border-td-none td { border: 0px solid; }
-.hiprint-printElement-tableTarget-border-td-all td:not(:nth-last-child(-n+2)) { border-right: 1px solid; }
-.hiprint-printElement-tableTarget-border-td-all td { border-left: 1px solid; }
-.hiprint-printElement-tableTarget-border-td-all td:last-child:first-child { border-left: none; }
-
-.hiprint-printPaper .hiprint-paperNumber {
-    font-size: 9pt;
-}
-
-.design .hiprint-printElement-table-handle {
-    position: absolute;
-    height: 12pt;
-    width: 12pt;
-    background: red;
-    z-index:1;
-}
-
-.hiprint-printPaper .hiprint-paperNumber-disabled {
-    float: right !important;
-    right: 0 !important;
-    color: gainsboro !important;
-}
-
-.hiprint-printElement-vline, .hiprint-printElement-hline {
-    border: 0px none rgb(0,0,0);
-
-}
-.hiprint-printElement-vline {
-    border-left: 0.75pt solid #000;
-    border-right: 0px none rgb(0,0,0) !important;
-    border-bottom: 0px none rgb(0,0,0) !important;
-    border-top: 0px none rgb(0,0,0) !important;
-}
-
-.hiprint-printElement-hline {
-    border-top: 0.75pt solid #000;
-    border-right: 0px none rgb(0,0,0) !important;
-    border-bottom: 0px none rgb(0,0,0) !important;
-    border-left: 0px none rgb(0,0,0) !important;
-}
-
-.hiprint-printElement-oval, .hiprint-printElement-rect {
-    border: 0.75pt solid #000;
-}
-
-.hiprint-text-content-middle {
-    display:table;
-}
-.hiprint-text-content-middle>div {
-    display: table-cell;
-    vertical-align:middle
-}
-
-.hiprint-text-content-bottom {
-    display: table;
-}
-
-    .hiprint-text-content-bottom > div {
-        display: table-cell;
-        vertical-align: bottom
-    }
-
-/*hi-grid-row */
-.hi-grid-row {
-    position: relative;
-    height: auto;
-    margin-right: 0;
-    margin-left: 0;
-    zoom: 1;
-    display: block;
-    box-sizing: border-box;
-}
-
-    .hi-grid-row::after, .hi-grid-row::before {
-        display: table;
-        content: '';
-        box-sizing: border-box;
-    }
-
-.hi-grid-col {
-    display: block;
-    box-sizing: border-box;
-    position: relative;
-    float: left;
-    flex: 0 0 auto;
-}
-
-.table-grid-row {
-    margin-left: -0pt;
-    margin-right: -0pt;
-}
-
-.tableGridColumnsGutterRow {
-    padding-left: 0pt;
-    padding-right: 0pt;
-}
-.hiprint-gridColumnsFooter {
-    text-align: left;
-    clear: both;
-}

package/dist/download-DTiI2jHs.js

@@ -1,15 +0,0 @@
-import { m as f } from "./chunk-Y7FY32AO-CBomeJj8.js";
-import { W as t } from "./chunk-MW6X4KTL-BGX4AdvZ.js";
-async function w(n, e) {
-  let c = ((e == null ? void 0 : e.format) || (e == null ? void 0 : e.type) || "").toLowerCase(), a = c === "jpg" ? "jpeg" : c || "png", i = (e == null ? void 0 : e.filename) || `snapdom.${a}`, o = { ...e || {}, format: a, type: a };
-  if (o.dpr = 1, a === "svg") {
-    let d = await f(n, { ...o, type: "svg" }), l = URL.createObjectURL(d), m = document.createElement("a");
-    m.href = l, m.download = i, m.click(), URL.revokeObjectURL(l);
-    return;
-  }
-  let p = await t(n, o), r = document.createElement("a");
-  r.href = p.toDataURL(`image/${a}`, e == null ? void 0 : e.quality), r.download = i, r.click();
-}
-export {
-  w as download
-};