cloud-web-corejs 1.0.54-dev.798 → 1.0.54-dev.799

package/src/components/xform/form-render/container-item/data-table-mixin.js

@@ -26,6 +26,12 @@ import {
   resolveColumnRequiredFlag,
 } from "../../../../components/xform/utils/tableColumnHelper";
 import { mergeQueryParam } from "../../../../components/xform/utils/queryParamUtil";
+import { isUrlValueColumn } from "../../../../components/xform/utils/attachmentValueUtil";
+import {
+  EXPORT_TYPE,
+  isItemExport,
+  requiresCheckedRows,
+} from "../../../../components/excelExport/exportType";
 import {
   buildCellRequiredHint,
   buildTableCellFormProp,
@@ -2572,8 +2578,12 @@ modules = {
               let originOption = $grid.params.originOption;
               let formData = {};
 
-              if (customParam?.exportParam?.type !== "exportItem") {
-                //非导出明细
+              // 明细·选择导出已按勾选行 id 精确定位，再叠加主表搜索条件既无意义、又可能
+              // 与明细口径的字段名冲突造成双重过滤，故只有它排除搜索条件；
+              // 明细·条件导出与主表条件导出一样，必须带上搜索条件。
+              if (
+                customParam?.exportParam?.type !== EXPORT_TYPE.ITEM_SELECTED
+              ) {
                 formData = tableOption.param ? tableOption.param() || {} : {};
               }
               const queryParams = Object.assign({}, formData);
@@ -2993,13 +3003,29 @@ modules = {
       let result = [];
       this.loodHandleColumns(this.widget.options.tableColumns, (item) => {
         if (!item.children?.length && item.prop && item.label) {
-          if (item.formatS === "editAttachment") {
+          // 开了「值存为URL」的附件列是明细表自己的普通列，不走独立附件通道
+          if (item.formatS === "editAttachment" && !isUrlValueColumn(item)) {
             result.push(item.prop);
           }
         }
       });
       return result;
     },
+    /**
+     * 开了「值存为URL」的附件列 prop 集合。这类列的值是 URL 字符串、存在明细表
+     * 自己的列上，凡是按「附件」特殊处理的链路（attachmentType 上送、保存时
+     * attachments_ 提包）都要把它排除掉。
+     * @returns {Array<String>}
+     */
+    getUrlValueAttachmentProps() {
+      let result = [];
+      this.loodHandleColumns(this.widget.options.tableColumns, (item) => {
+        if (!item.children?.length && item.prop && isUrlValueColumn(item)) {
+          result.push(item.prop);
+        }
+      });
+      return result;
+    },
     /** @returns {Array} 当前表格使用的三级表字段。 */
     getThirdtabm() {
       /* let vailColumns = this.widget.options.tableColumns.filter(
@@ -3123,7 +3149,8 @@ modules = {
       let scriptCode = this.getScriptCode();
       let accessParam = {};
       let otherParam = {};
-      if (customParam?.exportParam?.type === "exportItem") {
+      let exportType = customParam?.exportParam?.type;
+      if (isItemExport(exportType)) {
         let $grid = this.getGridTable();
         let originOption = $grid.params.originOption;
         let exportItemConfig = originOption.exportItemConfig || {};
@@ -3132,9 +3159,14 @@ modules = {
         }
         if (exportItemConfig.columns?.length) {
           let result = [];
+          // 导出用的是 vxe 列(field/title)，拿不到组件 schema，按 prop 反查 URL 模式列
+          let urlValueProps = this.getUrlValueAttachmentProps();
           this.loodHandleColumns(exportItemConfig.columns, (item) => {
             if (!item.children?.length && item.field && item.title) {
-              if (item.field.startsWith("attachments_")) {
+              if (
+                item.field.startsWith("attachments_") &&
+                urlValueProps.indexOf(item.field) === -1
+              ) {
                 result.push(item.field);
               }
             }
@@ -3143,14 +3175,16 @@ modules = {
             otherParam.attachmentType = result;
           }
         }
-        let ids = $grid.getCheckboxRecords(true).map((item) => {
-          return item.id;
-        });
-
-        if (originOption.exportItemConfig.param) {
-          accessParam = originOption.exportItemConfig.param() || {};
+        if (exportItemConfig.param) {
+          accessParam = exportItemConfig.param() || {};
+        }
+        // 只有选择模式以勾选行 id 为过滤条件；条件模式下由搜索条件 + exportItemParam 决定范围，
+        // 写入空的 ids 会被后端当成"无匹配"。
+        if (requiresCheckedRows(exportType)) {
+          accessParam.ids = $grid.getCheckboxRecords(true).map((item) => {
+            return item.id;
+          });
         }
-        accessParam.ids = ids;
       } else {
         accessParam = this.getAccessParam() || {};
         let attachmentType = this.getAttachmentType();
@@ -3311,6 +3345,12 @@ modules = {
         nullValue = [];
       } else if (widgetType === "vabsearch" && widget.options.multipleChoices) {
         nullValue = [];
+      } else if (
+        isAttachmentWidgetType(widgetType) &&
+        widget.options.urlValueEnabled
+      ) {
+        /* 开了「值存为URL」的附件列存的是 URL 字符串，空值不能给 [] */
+        nullValue = null;
       } else if (
         multiWidgetTypes.includes(widgetType) ||
         isAttachmentWidgetType(widgetType)
@@ -4204,8 +4244,14 @@ modules = {
         let formData = {
           [entity]: mainData,
         };
+        // attachments_ 开头的键要提到顶层当独立附件包发；但开了「值存为URL」的
+        // 附件列存的是本表自己列上的 URL 字符串，提出去主表列就存不到了
+        let urlValueProps = this.getUrlValueAttachmentProps();
         Object.keys(mainData).forEach((key) => {
-          if (key.startsWith("attachments_")) {
+          if (
+            key.startsWith("attachments_") &&
+            urlValueProps.indexOf(key) === -1
+          ) {
             formData[key] = mainData[key];
           }
         });

package/src/components/xform/form-render/container-item/detail-item.vue

@@ -101,18 +101,59 @@
           </template>
         </div>
       </div>
+      <!-- 正文区：panes 是通用容器列表,既可直接挂 detail-pane(模块),也可挂 tab 等其它容器。
+           baseTabs 的锚点导航靠 getTabs() 探测 slot 子级:detail-pane 带 tabPaneGrade=2 会被收进
+           navList;tab 等容器两个条件都不满足,被静默跳过——即标签内的模块不进外层导航,由标签内
+           自己的 detail-plain 负责(见 docs/详情模块标签承载方案.md)。 -->
       <baseTabs :showNav="!widget.options.hideNav && !plainMode">
-        <detail-pane-widget
-          v-for="(paneWidget, index) in widget.panes"
-          :key="index"
-          :widget="paneWidget"
-          :parent-list="widget.panes"
-          :index-of-parent-list="index"
-          :parent-widget="widget"
-          :col-height="widget.options.colHeight"
-          tabRef="baseTabRef"
-          :tabPaneGrade="2"
-        ></detail-pane-widget>
+        <template v-for="(paneWidget, index) in widget.panes">
+          <detail-pane-widget
+            v-if="paneWidget.type === 'detail-pane'"
+            :key="paneWidget.id || index"
+            :widget="paneWidget"
+            :parent-list="widget.panes"
+            :index-of-parent-list="index"
+            :parent-widget="widget"
+            :col-height="widget.options.colHeight"
+            tabRef="baseTabRef"
+            :tabPaneGrade="2"
+          ></detail-pane-widget>
+          <component
+            v-else-if="'container' === paneWidget.category"
+            :is="paneWidget.type + '-item'"
+            :key="paneWidget.id || index"
+            :widget="paneWidget"
+            :parent-list="widget.panes"
+            :index-of-parent-list="index"
+            :parent-widget="widget"
+          >
+            <!-- 递归传递插槽！！！ -->
+            <template
+              v-for="slot in Object.keys($scopedSlots)"
+              v-slot:[slot]="scope"
+            >
+              <slot :name="slot" v-bind="scope" />
+            </template>
+          </component>
+          <component
+            v-else
+            :is="paneWidget.type + '-widget'"
+            :key="paneWidget.id || index"
+            :field="paneWidget"
+            :designer="null"
+            :parent-list="widget.panes"
+            :index-of-parent-list="index"
+            :parent-widget="widget"
+          >
+            <!-- 递归传递插槽！！！ -->
+            <template
+              v-for="slot in Object.keys($scopedSlots)"
+              v-slot:[slot]="scope"
+            >
+              <slot :name="slot" v-bind="scope" />
+            </template>
+          </component>
+        </template>
       </baseTabs>
     </div>
   </container-item-wrapper>

package/src/components/xform/form-render/container-item/tab-item.vue

@@ -4,13 +4,15 @@
     :class="widget.options.isFullscreen ? 'full-height' : ''"
   >
     <div :key="widget.id" class="tab-container mHeight" v-show="!widget.options.hidden">
+      <!-- 高度默认 auto(跟随内容)：没在属性面板配 height 就不设。
+           原来兜底成固定 300px，内容多了内部滚动、少了留白，装详情内容模块时尤其别扭 -->
       <el-tabs
         v-model="activeTabName"
         :type="widget.displayType"
         :ref="widget.id"
         :class="[customClass, widget.options.tabClass]"
         :style="{
-          height: widget.options.isFullscreen ? '' : widget.options.height || '300px',
+          height: widget.options.isFullscreen ? '' : widget.options.height,
         }"
       >
         <el-tab-pane
@@ -121,5 +123,7 @@ export default {
 </script>
 
 <style lang="scss" scoped>
-  ::v-deep .mHeight .el-tabs .el-tabs__content{min-height:312px}
+  /* 内容区高度跟随内容。原来写死 min-height:312px，会把上面 height:auto 的效果整个抵消掉
+     （无论内容多少都至少 312px）。这里只留一个小兜底，保证空标签页不塌成一条线。 */
+  ::v-deep .mHeight .el-tabs .el-tabs__content{min-height:60px}
 </style>

package/src/components/xform/form-render/indexMixin.js

@@ -27,6 +27,7 @@ import {
   getColumnWidgetOptions,
   applyColumnMetaToFieldWidget,
   applyColumnMetaToColumnRow,
+  cloneColumnFieldWidget,
   isArrayValueWidgetType,
   isEmptyArrayFieldValue,
   XFORM_SYSTEM_FIELDS,
@@ -41,6 +42,7 @@ import {
   hiddenWidgetTypesOfWf,
   freeWidgetTypesOfWf,
 } from "../../../components/xform/form-designer/widget-panel/widgetsConfig.js";
+import { isUrlValueColumn } from "../../../components/xform/utils/attachmentValueUtil";
 import scriptHttpMixin from "../../../components/xform/mixins/scriptHttp";
 import defaultHandleMixin from "../../../components/xform/mixins/defaultHandle";
 import xeUtils from "xe-utils";
@@ -660,10 +662,22 @@ modules = {
           }
         } else {
           let type1 = columnFormatMap[t.formatS];
+          let type2 = columnFormatMap[t.editFormatS];
+          // 展示/编辑同类型且只配了一方时，另一方从已配置的一方复制：
+          // 按类型新建的是空白 schema，defaultValue、optionItems、searchDialogConfig
+          // 等只配在一方的属性会丢，编辑表新增行取 editWidget 默认值时同样受影响。
+          let inheritable = !!type1 && type1 === type2;
           if (type1) {
             if (!t.widget) {
-              let fieldWidget = this.getColumnWidget(t, false);
-              t.widget = fieldWidget;
+              if (inheritable && t.editWidget) {
+                t.widget = applyColumnMetaToFieldWidget(
+                  cloneColumnFieldWidget(t.editWidget),
+                  t,
+                  false
+                );
+              } else {
+                t.widget = this.getColumnWidget(t, false);
+              }
             } else {
               applyColumnMetaToFieldWidget(t.widget, t, false);
             }
@@ -672,11 +686,17 @@ modules = {
               this.normalizeActionColumnWidget(t.widget, t.formatS);
             }
           }
-          let type2 = columnFormatMap[t.editFormatS];
           if (type2) {
             if (!t.editWidget) {
-              let fieldWidget = this.getColumnWidget(t, true);
-              t.editWidget = fieldWidget;
+              if (inheritable && t.widget) {
+                t.editWidget = applyColumnMetaToFieldWidget(
+                  cloneColumnFieldWidget(t.widget),
+                  t,
+                  true
+                );
+              } else {
+                t.editWidget = this.getColumnWidget(t, true);
+              }
             } else {
               applyColumnMetaToFieldWidget(t.editWidget, t, true);
             }
@@ -1658,17 +1678,29 @@ modules = {
                   t.buildDataFromWidget(e);
                 });
             });
-        else if ("detail" === e.type || "detail-plain" === e.type)
-          e.panes &&
-            e.panes.length > 0 &&
-            e.panes.forEach(function (e) {
-              e.widgetList &&
-                e.widgetList.length > 0 &&
-                e.widgetList.forEach(function (e) {
-                  t.buildDataFromWidget(e);
-                });
+        else if ("detail" === e.type || "detail-plain" === e.type) {
+          // 递归下钻。原来是写死两层展开 panes[].widgetList,而 panes 现在是通用容器列表——
+          // 除 detail-pane(内容模块)外还可能挂 tab 容器承载标签,写死两层会把标签下的字段
+          // 整支漏掉,表现为数据不绑定。
+          // 注:detail.widgetList(标题栏按钮区)沿用原口径,仍不参与建模。
+          if (e.panes) {
+            e.panes.forEach(function (paneItem) {
+              t.buildDataFromWidget(paneItem);
+            });
+          }
+        } else if ("detail-pane" === e.type) {
+          // 模块正文 + 模块标题栏按钮区。后者原先漏建模,按钮区里放字段组件时取不到值。
+          if (e.widgetList) {
+            e.widgetList.forEach(function (childItem) {
+              t.buildDataFromWidget(childItem);
             });
-        else if ("sub-form" === e.type) {
+          }
+          if (e.buttonWidgetList) {
+            e.buttonWidgetList.forEach(function (childItem) {
+              t.buildDataFromWidget(childItem);
+            });
+          }
+        } else if ("sub-form" === e.type) {
           let i = e.options.name;
           if (currentFormData.hasOwnProperty(i)) {
             let n = currentFormData[i];
@@ -2932,7 +2964,9 @@ modules = {
           } else if (
             item.prop &&
             item.label &&
-            item.formatS === "editAttachment"
+            item.formatS === "editAttachment" &&
+            // 开了「值存为URL」的附件列是明细表自己的普通列，不走独立附件通道
+            !isUrlValueColumn(item)
           ) {
             result.push(item.prop);
           }
@@ -2984,6 +3018,8 @@ modules = {
       let result = [];
       getAllFieldWidgets(widgetList).forEach((w) => {
         if (w.field && excludeTypes.indexOf(w.type) !== -1) {
+          // 开了「值存为URL」的附件字段是主表普通列，值随 getOne 一起回来，不发独立包
+          if (w.field.options && w.field.options.urlValueEnabled) return;
           result.push({
             name: this.getFieldKeyName(w.field),
             scriptCode: w.field.options.formScriptCode || "getList",
@@ -3337,6 +3373,10 @@ modules = {
           options.excludeTypes || this.compareExcludeTypes || [];
         this.getFieldWidgets().forEach((w) => {
           if (excludeTypes.indexOf(w.type) === -1) return;
+          // URL 模式字段存的是字符串，不是文件对象，不需要按白名单精简
+          if (w.field && w.field.options && w.field.options.urlValueEnabled) {
+            return;
+          }
           attachKeySet[this.getFieldKeyName(w.field)] = true;
         });
       }

package/src/components/xform/lang/zh-CN.js

@@ -92,8 +92,9 @@ export default {
       panel: "面板",
       query: "查询模块",
       detail: "详情模块",
+      "detail-tabs": "详情模块(标签)",
       "detail-plain": "详情模块(简洁)",
-      "detail-pane": "详情tab",
+      "detail-pane": "内容模块",
       "detail-h5": "H5详情",
       "list-h5": "H5列表",
       text: "文本",

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/util.js

@@ -99,6 +99,13 @@ export function isEmptyArrayFieldValue(value, type, options = {}) {
       (item) => item === null || item === undefined || item === ""
     );
   }
+  /* 附件字段开了「值存为URL」且限制数量为 1 时，模型里存的是单个 URL 字符串，
+     不能按空数组判空，否则必填校验永远不通过 */
+  if (isAttachmentWidgetType(type) && options.urlValueEnabled) {
+    if (typeof value === "string") {
+      return !value.trim();
+    }
+  }
   if (!Array.isArray(value)) {
     return true;
   }
@@ -851,6 +858,26 @@ export function getColumnWidgetOptions(row, isEdit = false) {
   return row.widgetOptions ?? row.columnOption;
 }
 
+/**
+ * 复制列内 field widget，用于展示组件与编辑组件同类型、只配置了其中一方的列。
+ * 另一方若按类型新建空白 schema，只配在已有一方的 defaultValue / optionItems /
+ * searchDialogConfig 等会全部丢失（编辑表新增行取默认值同样受影响）。
+ * 字段绑定 keyName 保持不变；id 与 name 必须重新生成——refList 按
+ * options.name + 行键 注册，fieldSchemaMap 按 id 索引，两个组件同名会互相覆盖。
+ */
+export function cloneColumnFieldWidget(fieldWidget) {
+  if (!fieldWidget) {
+    return null;
+  }
+  let newWidget = deepClone(fieldWidget);
+  newWidget.id = String(newWidget.type).replace(/-/g, "") + generateId();
+  if (newWidget.hasOwnProperty("tableField")) {
+    newWidget.tableField = newWidget.id;
+  }
+  newWidget.options.name = newWidget.id;
+  return newWidget;
+}
+
 /** 将列级 label / keyName / required 同步到列内 field widget（动态列 label 在列顶层） */
 export function applyColumnMetaToFieldWidget(fieldWidget, row, isEdit = false) {
   if (!fieldWidget || !row) {