cloud-web-corejs 1.0.276 → 1.0.277

package/src/components/xform/utils/attachmentValueUtil.js

@@ -0,0 +1,239 @@
+/**
+ * 附件字段值归一工具。
+ *
+ * 附件组件(baseUpload / base-attachment)只认「附件对象」这一种形态：
+ * { domain, url, thumbnail, medium, large, source, name, extension, ... }，
+ * 其中 domain 与路径是分开的两个字段，渲染时靠 domain + url 拼接。
+ * 外部(接口返回、setValue 脚本、字段默认值)常常直接给一个完整 URL 字符串或
+ * URL 数组，两个组件对这种值的容忍度不一致(vabUpload 丢裸字符串、baseAttachment
+ * 裂数组内的字符串)，故在字段层统一归一：进来的一律转成附件对象数组，出去的按
+ * 字段配置决定是对象数组还是 URL 字符串。
+ */
+import Vue from "vue";
+
+/* 顶层字符串支持逗号/换行分隔多个 URL */
+const URL_SEPARATOR_REG = /[,\n\r]+/;
+/* 协议(或协议相对) + 域名 */
+const DOMAIN_REG = /^((?:https?:)?\/\/[^/]+)/i;
+
+function isPlainObject(val) {
+  return Object.prototype.toString.call(val) === "[object Object]";
+}
+
+/* $commonFileUtil 挂在 Vue.prototype 上(src/utils/vab.js)，这里延迟取，
+   避免 util 直接 import vab.js(它会拉起 request/store/element-ui 全家桶)。 */
+function getFileUtil() {
+  let fileUtil = Vue.prototype.$commonFileUtil;
+  if (!fileUtil && typeof window !== "undefined" && window.$vueRoot) {
+    fileUtil = window.$vueRoot.$commonFileUtil;
+  }
+  return fileUtil || null;
+}
+
+/* 图片判定必须复用 $commonFileUtil，另造一套白名单会和渲染层
+   getShowUrl 的判定打架(它的白名单不含 svg/tif) */
+function isPictureFile(purePath) {
+  let fileUtil = getFileUtil();
+  return fileUtil ? !!fileUtil.isPictureFile(purePath) : false;
+}
+
+function getExtension(fileName) {
+  let i = fileName.lastIndexOf(".");
+  return i < 0 ? "" : fileName.substring(i + 1).toLowerCase();
+}
+
+/**
+ * 解析一个 URL(绝对/协议相对/相对路径)为附件对象。
+ * 非法输入返回 null(不抛异常)，调用方无需 try/catch。
+ *
+ * @param {String} fileUrl
+ * @returns {Object|null} { domain, url, thumbnail, medium, large, source, name, extension }
+ */
+export function parseFileUrl(fileUrl) {
+  if (typeof fileUrl !== "string") {
+    if (fileUrl !== null && fileUrl !== undefined) {
+      console.warn("[attachmentValueUtil] 附件 URL 必须是字符串:", fileUrl);
+    }
+    return null;
+  }
+  let value = fileUrl.trim();
+  if (!value) return null;
+
+  let domain = "";
+  let url = value;
+  let domainMatch = value.match(DOMAIN_REG);
+  if (domainMatch) {
+    domain = domainMatch[0];
+    url = value.substring(domain.length);
+    if (!url || url === "/") {
+      console.warn("[attachmentValueUtil] URL 缺少文件路径部分:", fileUrl);
+      return null;
+    }
+  }
+
+  /* 后缀与文件名要按剥掉 query/hash 的纯路径算(a.png?sign=xx 否则会被当成
+     非图片)，但 url/medium 等字段必须保留含 query 的原始路径——签名 URL 依赖它 */
+  let purePath = url.split(/[?#]/)[0];
+  let i = purePath.lastIndexOf("/");
+  let fileName = i >= 0 ? purePath.substring(i + 1) : purePath;
+  if (!fileName) {
+    console.warn("[attachmentValueUtil] 无法从 URL 中提取文件名:", fileUrl);
+    return null;
+  }
+  try {
+    fileName = decodeURIComponent(fileName);
+  } catch (e) {
+    /* 非法转义序列，保留原文件名 */
+  }
+
+  let extension = getExtension(fileName);
+  /* 非图片不填缩略图字段，与 obsUpload 的既有做法一致；渲染层拿不到 medium
+     会退回 url 并显示文件类型图标 */
+  let picture = isPictureFile(purePath);
+
+  return {
+    domain,
+    url,
+    thumbnail: picture ? url : null,
+    medium: picture ? url : null,
+    large: picture ? url : null,
+    source: picture ? url : null,
+    name: fileName,
+    extension,
+  };
+}
+
+/**
+ * 把任意形态的附件字段值归一成附件对象数组。
+ * 支持：null / 字符串 / 逗号或换行分隔的字符串 / 字符串数组 / 对象 / 对象数组 / 混合数组。
+ * 已经是对象的原样保留——重新解析会丢掉后端字段(id、fileSize、createDate、attachCode 等)。
+ *
+ * @param {*} val
+ * @returns {Array<Object>}
+ */
+export function normalizeAttachmentValue(val) {
+  if (val === null || val === undefined || val === "") return [];
+
+  let list;
+  if (Array.isArray(val)) {
+    /* 已经全是附件对象(无需转换)时必须原样返回，不能新建数组：调用方会把它写回
+       表单模型，而 fieldMixin.initValueWatchEvent 监听模型值——换一个新数组就等于
+       模型值"变了"，会被灌回 fieldModel 再触发一轮回写，无限循环（查询列表里每行
+       一个附件单元格，一查询整页卡死）。空数组同理。 */
+    if (val.every(isPlainObject)) return val;
+    list = val;
+  } else if (isPlainObject(val)) {
+    return Object.keys(val).length ? [val] : [];
+  } else if (typeof val === "string") {
+    list = val.split(URL_SEPARATOR_REG);
+  } else {
+    console.warn("[attachmentValueUtil] 无法识别的附件值:", val);
+    return [];
+  }
+
+  let rows = [];
+  list.forEach((item) => {
+    if (!item) return;
+    if (isPlainObject(item)) {
+      rows.push(item);
+      return;
+    }
+    let row = parseFileUrl(item);
+    if (row) rows.push(row);
+  });
+  return rows;
+}
+
+/**
+ * 附件对象数组 → URL 字符串。拼接规则与 baseUpload 的 dataType 分支一致。
+ *
+ * @param {Array} rows
+ * @param {Object} opts { field: "url"(原文件)|"large"|"medium"|"thumbnail", multi: Boolean }
+ * @returns {String|null|Array<String>} multi 为 false 返回单个字符串，否则返回字符串数组
+ */
+export function toUrlValue(rows, opts) {
+  let options = opts || {};
+  /* 取值字段为空(非图片没有大中小图、旧配置没维护过)时一律退回 url */
+  let field = options.field || "url";
+  /* 入参兜底：模型值可能是字符串(单值 URL 模式)，不能直接 .map */
+  let list = Array.isArray(rows) ? rows : rows ? [rows] : [];
+  let urls = list
+    .map((row) => {
+      if (!row) return null;
+      if (typeof row === "string") return row;
+      if (!isPlainObject(row)) return null;
+      return (row.domain || "") + (row[field] || row.url || "");
+    })
+    .filter((url) => !!url);
+  if (options.multi === false) {
+    return urls.length ? urls[0] : null;
+  }
+  return urls;
+}
+
+/**
+ * 附件字段是否按多值处理。沿用组件既有约定：限制数量为 1 即单值。
+ */
+export function isUrlValueMulti(fieldOptions) {
+  return !(fieldOptions && Number(fieldOptions.limit) === 1);
+}
+
+/**
+ * 内部值(附件对象数组) → 落到表单模型的值。
+ * 未开启 urlValueEnabled 时保持附件对象数组，开启后转成 URL 字符串(单值)或字符串数组。
+ */
+export function toModelValue(rows, fieldOptions) {
+  if (!fieldOptions || !fieldOptions.urlValueEnabled) return rows;
+  return toUrlValue(rows, {
+    field: fieldOptions.urlValueField || "url",
+    multi: isUrlValueMulti(fieldOptions),
+  });
+}
+
+/**
+ * 两个「落到表单模型的值」是否等价。URL 模式下模型值是 String | Array<String> | null，
+ * 而 toModelValue 每次都产出新数组——不比一下就回写，会和 fieldMixin 的
+ * initValueWatchEvent（模型一变就把模型值灌回 fieldModel）形成死循环。
+ */
+export function isSameModelValue(a, b) {
+  if (a === b) return true;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    return a.every((item, index) => item === b[index]);
+  }
+  return false;
+}
+
+/**
+ * 数据表的附件列是否开了「值存为URL」。列的组件 schema 挂在 widget(显示态) /
+ * editWidget(编辑态) 上，两者同属一列，任一开启即按普通列处理——它的值是 URL
+ * 字符串，存在明细表自己的列上，不走 attachmentType 独立附件通道。
+ */
+export function isUrlValueColumn(column) {
+  if (!column) return false;
+  let options = column.editWidget && column.editWidget.options;
+  if (!options) {
+    options = column.widget && column.widget.options;
+  }
+  return !!(options && options.urlValueEnabled);
+}
+
+/**
+ * 归一前后是否等价。用于避免在 created 里无谓地重新赋值 fieldModel——
+ * 换一个新数组会让 watcher 白触发一次 onChange。
+ */
+export function isSameAttachmentRows(rows, val) {
+  if (!Array.isArray(val) || rows.length !== val.length) return false;
+  return rows.every((row, index) => row === val[index]);
+}
+
+export default {
+  parseFileUrl,
+  normalizeAttachmentValue,
+  toUrlValue,
+  isUrlValueMulti,
+  toModelValue,
+  isSameModelValue,
+  isUrlValueColumn,
+  isSameAttachmentRows,
+};

package/src/components/xform/utils/fixedQueryUtil.js

@@ -0,0 +1,93 @@
+/**
+ * 「固定查询条件」判定工具。
+ *
+ * 数据表格查询区的字段值存在整张表单的 formModel 上，三条通道会把它清掉：
+ *   1. 刷新按钮 → resetForm 逐个 setValue(null)
+ *   2. 「查询条件设置」的「确定」→ tableFormMixin.dialogPrimary 按列写默认值
+ *   3. 「查询条件设置」的「还原」→ 走的就是 dialogPrimary
+ * 字段勾上 options.fixedQuery 之后，这三条通道一律跳过它，值保持原样
+ * (值本身仍由树点选/脚本 setValue 等业务通道注入，本开关只管「不被清掉」)。
+ *
+ * 组装 searchColumns 时(见 container-item/data-table-mixin.js)由 fixedQuery
+ * 派生出两个列级标记：
+ *   - lockValue：公共表格层(components/table)据此跳过写值，语义是「值锁定」
+ *   - fixed：复用公共层已有语义，让个性化 json 回灌时不挪位置、不改常用
+ * 两者必须分开：手写页面的固定列(如 branchSearchPage 的分支)只打 fixed，
+ * 它**依赖** dialogPrimary 按 defaultValue 回填，不能被 lockValue 一起跳过。
+ */
+
+/* 能承载子组件的字段名，覆盖各类容器(含 vf-dialog/vf-drawer，loopHandleWidget 不进这两个) */
+const CHILD_KEYS = [
+  "widgetList",
+  "cols",
+  "rows",
+  "tabs",
+  "panes",
+  "buttons",
+  "buttonWidgetList",
+  "leftWidgetList",
+];
+
+/**
+ * 深度遍历组件树节点（含 rows 这类只有 cols 的中间层对象）。
+ * @param {Object} node 起始节点
+ * @param {Function} callback 每个节点回调
+ */
+function walkWidget(node, callback) {
+  if (!node || typeof node !== "object") return;
+  callback(node);
+  CHILD_KEYS.forEach((key) => {
+    let children = node[key];
+    if (Array.isArray(children)) {
+      children.forEach((child) => walkWidget(child, callback));
+    }
+  });
+}
+
+/**
+ * 该字段是否勾选了「固定查询条件」。
+ * @param {Object} widget 字段组件 schema
+ * @returns {Boolean}
+ */
+export function isFixedQueryWidget(widget) {
+  return !!(widget && widget.options && widget.options.fixedQuery);
+}
+
+/**
+ * 该列是否为「值锁定」列（公共表格层的口径，见文件头注释）。
+ * @param {Object} column searchColumns 的列配置
+ * @returns {Boolean}
+ */
+export function isLockedSearchColumn(column) {
+  return !!(column && column.lockValue);
+}
+
+/**
+ * 组件是否位于某个数据表格的查询区（data-table 的 widgetList 分支，不含 buttons、
+ * 不含表格列组件）。属性面板据此决定要不要显示「固定查询条件」开关。
+ * @param {Array} widgetList 表单顶层组件列表（designer.widgetList）
+ * @param {Object} widget 待判定的字段组件
+ * @returns {Boolean}
+ */
+export function isQueryAreaWidget(widgetList, widget) {
+  if (!widget || !widget.id || !Array.isArray(widgetList)) return false;
+  let inQueryArea = false;
+  widgetList.forEach((item) => {
+    walkWidget(item, (node) => {
+      if (inQueryArea) return;
+      if (
+        node.category !== "container"
+        || node.type !== "data-table"
+        || !Array.isArray(node.widgetList)
+      ) {
+        return;
+      }
+      node.widgetList.forEach((child) => {
+        walkWidget(child, (sub) => {
+          if (sub.id === widget.id) inQueryArea = true;
+        });
+      });
+    });
+  });
+  return inQueryArea;
+}