cloud-web-corejs 1.0.54-dev.796 → 1.0.54-dev.797

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.0.54-dev.796",
+  "version": "1.0.54-dev.797",
   "scripts": {
     "dev": "vue-cli-service serve",
     "dev:micro": "vue-cli-service serve --port 17527",

package/src/components/formDialog/README.md

@@ -276,7 +276,10 @@ const result = await this.$formDrawer({
   // size: "62%", direction: "rtl",  // el-drawer 外观，drawerConfig 可整体透传
   // dataId: row.id,           // 详情单据 id —— 详情场景必传，xform 靠它加载单据数据
   // model: {...},             // 初始表单数据（新增态/自定义数据时用）
-  // param: {...},             // 透传 VFormRender 的 param
+  // param: {...},             // 透传 VFormRender 的 param（只给模板脚本用，不参与请求）
+  // queryParam: {...},        // 合并进目标表单查询表格的请求参数（host:"list" 下不生效），见下
+  //   { warehouseId: 7 }                          // 平铺参数：给后台脚本读（formScriptParam 那套约定）
+  //   { condition: { status: 1, type: ["A","B"] } }  // 结构化条件：追加进查询区组装的 condition，同字段以此为准
   // conditionParam: { objId, objTypeCode, taskId },  // 流程/权限上下文
   // fillHeight: true,         // 强制内容区撑满（列表型模板默认自动开启）
   // host: "list",             // 用列表宿主页承载，带「常规(详情)/列表」页签，见下
@@ -330,11 +333,29 @@ const result = await this.$formDrawer({
 | 以列表页承载 | 即 `host: "list"` |
 | 打开方式 | 新增（不传 dataId）/ 详情 |
 | 单据ID来源 | 当前控件值 / 指定表单字段 / 当前表格行字段 / 脚本。按钮类控件缺省用行字段（表格操作列场景） |
-| 自定义参数 | 脚本返回对象 → 壳的 `param` |
+| 查询参数 | 脚本返回对象 → 壳的 `queryParam`，合并进目标表单查询表格的请求参数（见下「查询参数与 condition」）。「以列表页承载」时不生效，该项在编辑器里也随之隐藏 |
+| 自定义参数 | 脚本返回对象 → 壳的 `param`，只透传给目标模板的脚本（`this.param`），不参与任何请求 |
 | 只读 | 抽屉走 `readonly`（只读态、底部仅「关闭」）；弹框走 `disabledMode`（整表禁用、底部按钮不变） |
 | 形态 | 弹框：宽度 / 全屏；抽屉：素身详情 / 尺寸 / 弹出方向 |
 | 关闭后事件 | 参数 `(formRef, result)`。`result` 即壳的收口值——默认按钮是表单数据、配置按钮是 `{action, data}`、取消/关闭是 `null`，脚本据此决定要不要刷新宿主表格。抽屉侧 `formRef` 为 `null` |
 
+### 查询参数与 condition
+
+查询表格发给后台的请求体是 `{ condition: [{ field, value, filter }...], current, size, searchCount, ...平铺参数 }`——
+`condition` 由查询区字段按控件类型自动组装（文本 like、日期 between、多选 in、单选 eq），平铺参数则给后台脚本读。
+宿主注入的 `queryParam` 按键分两路合并（`xform/utils/queryParamUtil.js`，PC 与 H5 两条查询链路共用）：
+
+| 写法 | 结果 |
+|---|---|
+| `{ warehouseId: 7 }` | 平铺覆盖，与改造前一致 |
+| `{ condition: { status: 1, type: ["A","B"] } }` | 对象简写 → `[{field:"status",value:1,filter:"eq"}, {field:"type",value:["A","B"],filter:"in"}]`，**追加**到查询区条件之后 |
+| `{ condition: { createTime: { value: ["2026-01-01","2026-12-31"], filter: "between" } } }` | 需要指定比较符时用 `{value, filter}` 形式 |
+| `{ condition: [{ field:"status", value:1, filter:"eq" }] }` | 原生数组，`filter` 可省（数组值补 `in`，其余补 `eq`） |
+
+同一个 `field` 上宿主条件覆盖查询区输入（先剔旧再追加），不会撞成两条。
+`condition` 不再整体覆盖——此前带 `condition` 的 `queryParam` 会把用户当场输入的查询条件一并清掉。
+注意值对象只有带 `value` 键才被当作 `{value, filter}` 解析，业务对象（如 `{ org: { id, name } }`）整体作为值传下去。
+
 底部按钮不在这里配——由目标表单模板自己的 `formConfig.actionButtons` 决定（就是上一节那份配置）。
 该动作**不做数据回填、不做选择模式**：要回填/选行请用「打开选择弹框」。
 实现在 `xform/form-designer/setting-panel/property-editor/field-button/clickBindActions.js`

package/src/components/formDrawer/drawer.vue

@@ -42,7 +42,7 @@
             :data-id="dataId"
             :conditionParam.sync="conditionParam"
             :param="drawerParam"
-            :dataTableOption="selectMode ? dataTableOption : undefined"
+            :dataTableOption="dataTableOption || undefined"
             :plain-detail-mode="plain"
             :parent-target="_self"
             visible-key="showRender"
@@ -183,7 +183,7 @@ export default {
       customButtons: null,
       btnLoadingMap: {},
       formRefMounted: false,
-      // PC 专用（不支持 H5）：选择行为注入 data-table
+      // PC 专用（不支持 H5）：选择行为 / 查询参数注入 data-table
       dataTableOption: null,
       $grid: null,
     };
@@ -281,6 +281,9 @@ export default {
         if (select.fieldKey) this.fieldKey = select.fieldKey;
         this._selectOption = select;
         this.initDataTableOption(select);
+      } else if (options.queryParam) {
+        // 非选择模式的查询参数：强制合并进目标表单查询表格的请求参数
+        this.dataTableOption = { queryParam: options.queryParam };
       }
 
       this.showWrap = true;

package/src/components/formDrawer/index.js

@@ -17,7 +17,7 @@ function loadCtor() {
 
 /**
  * JS 调用打开 formCode 抽屉。每次调用创建独立实例，支持叠开多层。
- * options：{ formCode, title, size, direction, param, conditionParam, plain,
+ * options：{ formCode, title, size, direction, param, queryParam, conditionParam, plain,
  *           select: {multiple, rows, fieldKey, queryParam, onConfirm},
  *           buttons, showFooter, readonly, onReady, beforeConfirm, model, ... }
  * resolve：默认按钮下 select 模式返回选中行数组、表单模式返回表单数据；

package/src/components/xform/form-designer/form-widget/dialog/formDialog.vue

@@ -30,6 +30,7 @@
         @reload="reload"
         v-bind="formConfig"
         :param="dialogParam"
+        :dataTableOption="dialogDataTableOption"
         class="data-table_height"
         @hook:mounted="handleFormMounted"
       />
@@ -133,6 +134,16 @@ export default {
     dialogParam() {
       return this.option?.param;
     },
+    /**
+     * option.queryParam：强制合并进目标表单查询表格的请求参数
+     * （data-table 从 formRef.$attrs.dataTableOption.queryParam 读取，优先级高于表单自身查询条件）。
+     * 与 param 不是一回事：param 只是透传给模板脚本用的打开参数，不参与请求。
+     */
+    dialogDataTableOption() {
+      return this.option?.queryParam
+        ? { queryParam: this.option.queryParam }
+        : undefined;
+    },
     // host:"list" —— 用列表宿主页承载（带「常规/列表」页签），而非直接渲染单个表单
     listHost() {
       return this.option?.host === "list";

package/src/components/xform/form-designer/form-widget/field-widget/baseAttachment-widget.vue

@@ -6,7 +6,11 @@
     <a href="javascript:void(0);" class="a-link nums" v-if="designState">
       <i class="iconfont icon-fujian3"/>
     </a>
-    <base-attachment :option.sync="option" v-else></base-attachment>
+    <!-- 关掉缩略图懒加载：附件列/字段常挂在初始隐藏的容器里(非首页签、默认折叠面板)，
+         el-image 的 lazy 只在 mounted 时判一次可视区，隐藏态判失败后仅靠滚动容器的 scroll
+         事件重试，页签切回来不产生 scroll，缩略图会永久停在空白占位。此处是 25px 缩略图，
+         懒加载收益可忽略。参见 wf.js 里同样传 imageLazy:false 的表格列。 -->
+    <base-attachment :option.sync="option" :image-lazy="false" v-else></base-attachment>
   </form-item-wrapper>
 </template>
 

package/src/components/xform/form-designer/setting-panel/property-editor/field-button/clickBindActions.js

@@ -49,6 +49,7 @@ export function buildDefaultFormHostConfig(ctx = {}) {
     dataIdField: null,
     dataIdScript: null,
     paramScript: null,
+    queryParamScript: null,
     // 呈现
     readonly: false,
     showFooter: true,
@@ -170,9 +171,15 @@ export function openFormHost(ctx, mode) {
   let dataId = resolveDataId(ctx, cfg);
   if (dataId === undefined) return; // 详情态取不到单据 ID，已提示
 
+  // param：透传 VFormRender 的 param prop，只给目标模板的脚本用，不参与请求
   let param = cfg.paramScript
     ? ctx.vm.handleCustomEvent(cfg.paramScript, ["rowData"], [ctx.rowData])
     : undefined;
+  // queryParam：强制合并进目标表单查询表格的请求参数（两个壳都转成 dataTableOption.queryParam）。
+  // host:"list" 时不生效——列表宿主页自己加载模板，没有这条注入通道，编辑器里也已隐藏该项。
+  let queryParam = cfg.queryParamScript
+    ? ctx.vm.handleCustomEvent(cfg.queryParamScript, ["rowData"], [ctx.rowData])
+    : undefined;
   let onClose = (formRef, result) => {
     if (cfg.onCloseScript) {
       ctx.vm.handleCustomEvent(
@@ -202,6 +209,7 @@ export function openFormHost(ctx, mode) {
         host: cfg.host || undefined,
         title: cfg.title || undefined,
         param: param,
+        queryParam: queryParam,
         dataId: dataId, // null=新增态
         plain: !!cfg.plain,
         readonly: !!cfg.readonly,
@@ -229,6 +237,7 @@ export function openFormHost(ctx, mode) {
       formCode: formCode,
       host: cfg.host || undefined,
       param: param,
+      queryParam: queryParam,
       // v-bind 到 VFormRender 的 props，只放 props（禁止 param/formJson/formData）
       formConfig: dropUndefined({
         dataId: dataId,

package/src/components/xform/form-designer/setting-panel/property-editor/field-button/form-host-event-editor.vue

@@ -51,12 +51,22 @@
       </template>
     </template>
 
+    <el-form-item label="查询参数" label-width="150px" v-if="!listHost">
+      <a href="javascript:void(0);" class="a-link link-oneLind"
+         @click="editEventHandler('queryParamScript', scriptParams, optionQueryParam)">
+        <span>{{ eventConfig.queryParamScript }}</span>
+        <i class="el-icon-edit"></i>
+      </a>
+      <span class="tips">脚本返回对象合并进目标表单查询表格的请求参数；按业务字段过滤写
+        <code>return {'{'} condition: {'{'} status: 1 {'}'} {'}'}</code>（追加进查询区条件，同字段以脚本为准）</span>
+    </el-form-item>
     <el-form-item label="自定义参数" label-width="150px">
       <a href="javascript:void(0);" class="a-link link-oneLind"
          @click="editEventHandler('paramScript', scriptParams, optionParam)">
         <span>{{ eventConfig.paramScript }}</span>
         <i class="el-icon-edit"></i>
       </a>
+      <span class="tips">脚本返回对象 → 目标表单的 param，只给模板脚本用，不参与请求</span>
     </el-form-item>
     <el-form-item label="只读">
       <el-switch v-model="eventConfig.readonly"></el-switch>
@@ -126,6 +136,7 @@ export default {
     return {
       optionFormCode: this.buildScriptOption("formCodeScript"),
       optionDataId: this.buildScriptOption("dataIdScript"),
+      optionQueryParam: this.buildScriptOption("queryParamScript"),
       optionParam: this.buildScriptOption("paramScript"),
       optionClose: this.buildScriptOption("onCloseScript"),
       // 脚本可用参数：dataId/formCode 由 getEventParam 统一注入，这里只列附加项
@@ -157,7 +168,9 @@ export default {
           return this.eventConfig[key];
         },
         callback: (code) => {
-          this.eventConfig[key] = code;
+          // $set 而非直接赋值：存量模板的 formHostConfig 没有后加的字段（如 queryParamScript），
+          // 直接赋值不会变成响应式，编辑器里改完不刷新
+          this.$set(this.eventConfig, key, code);
           this.$forceUpdate();
         }
       };

package/src/components/xform/form-designer/setting-panel/property-editor/field-button/search-dialog-event-editor.vue

@@ -21,6 +21,8 @@
         <span>{{ eventConfig.dialogQueryParam }}</span>
         <i class="el-icon-edit"></i>
       </a>
+      <span class="tips">按业务字段过滤写
+        <code>return {'{'} condition: {'{'} status: 1 {'}'} {'}'}</code>（追加进查询区条件，同字段以脚本为准）</span>
     </el-form-item>
     <el-form-item label="弹框自定义参数">
       <a href="javascript:void(0);" class="a-link link-oneLind"

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

@@ -25,6 +25,7 @@ import {
   applyColumnLabelIcon,
   resolveColumnRequiredFlag,
 } from "../../../../components/xform/utils/tableColumnHelper";
+import { mergeQueryParam } from "../../../../components/xform/utils/queryParamUtil";
 import {
   buildCellRequiredHint,
   buildTableCellFormProp,
@@ -2609,8 +2610,10 @@ modules = {
 
               // let formRef = that.getFormRef();
               // let dataTableConfig = formRef.$attrs.dataTableOption || {};
+              // 宿主（选择弹框/表单弹框/表单抽屉）注入的查询参数：condition 追加合并，
+              // 其余键平铺覆盖，见 utils/queryParamUtil.js
               if (that.dataTableConfig.queryParam) {
-                Object.assign(queryParams, that.dataTableConfig.queryParam);
+                mergeQueryParam(queryParams, that.dataTableConfig.queryParam);
               }
 
               let reqPath = typeof path === "function" ? path() : path;

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

@@ -754,6 +754,7 @@ import {
   markMaskedExportColumns,
 } from "../../../../components/xform/utils/textMaskUtil";
 import { extendDeeply } from "../../../../utils/index.js";
+import { mergeQueryParam } from "../../../../components/xform/utils/queryParamUtil";
 import render from "../../../../views/user/bill_setting/render.vue";
 
 const baseRefUtil = {
@@ -1238,8 +1239,9 @@ export default {
               queryParams.searchCount = isQueryAllPage !== false;
               Object.assign(queryParams, param);
 
+              // 与 PC 链路同规则：condition 追加合并，其余键平铺覆盖
               if (that.dataTableConfig.queryParam) {
-                Object.assign(queryParams, that.dataTableConfig.queryParam);
+                mergeQueryParam(queryParams, that.dataTableConfig.queryParam);
               }
 
               return new Promise((resolve, reject) => {

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

@@ -0,0 +1,84 @@
+/**
+ * 宿主注入查询表格的查询参数（dataTableOption.queryParam）合并规则。
+ *
+ * 查询表格发给后台的请求体形如：
+ *   { condition: [{ field, value, filter }, ...], current, size, searchCount, ...其它平铺参数 }
+ * 其中 `condition` 由查询区字段按类型自动组装（见 data-table-mixin.js 的 getSearchFormData），
+ * 平铺参数则是给后台脚本（formScriptParam 那套约定）读的。
+ *
+ * 宿主（选择弹框 / 表单弹框 / 表单抽屉）传进来的 queryParam 此前是整体 Object.assign，
+ * 于是带 `condition` 的写法会把查询区当场输入的条件**整个覆盖掉**。这里把 `condition`
+ * 单独拿出来做追加合并，其余键保持原来的平铺覆盖语义。
+ *
+ * 使用方：data-table-mixin.js（PC）、list-h5-item.vue（H5）两条查询链路。
+ */
+
+/** 未显式给 filter 时的默认比较符：数组按 in，其余按 eq（宿主条件是精确过滤，不该默认 like） */
+function defaultFilter(value) {
+  return Array.isArray(value) ? "in" : "eq";
+}
+
+/**
+ * 把 condition 归一成 [{ field, value, filter }]。接受三种写法：
+ *   1. 数组：[{ field: "status", value: 1, filter: "eq" }]（原生格式，filter 可省）
+ *   2. 对象简写：{ status: 1, type: ["A", "B"] } → filter 自动取 eq / in
+ *   3. 对象 + 比较符：{ createTime: { value: ["2026-01-01", "2026-12-31"], filter: "between" } }
+ * @param {Array|Object} condition
+ * @returns {Array} 归一后的条件项数组；无效输入返回空数组
+ */
+export function normalizeCondition(condition) {
+  if (!condition) return [];
+  if (Array.isArray(condition)) {
+    return condition
+      .filter((item) => item && item.field)
+      .map((item) => ({
+        ...item,
+        filter: item.filter || defaultFilter(item.value),
+      }));
+  }
+  if (typeof condition !== "object") return [];
+  return Object.keys(condition).map((field) => {
+    let raw = condition[field];
+    // 只有「纯对象且带 value 键」才当成 {value, filter} 写法，避免把业务对象拆错
+    let isDetail
+      = raw
+      && typeof raw === "object"
+      && !Array.isArray(raw)
+      && Object.prototype.hasOwnProperty.call(raw, "value");
+    let value = isDetail ? raw.value : raw;
+    return {
+      field: field,
+      value: value,
+      filter: (isDetail && raw.filter) || defaultFilter(value),
+    };
+  });
+}
+
+/**
+ * 合并宿主 queryParam 到请求参数上（原地修改 queryParams 并返回它）。
+ * - `condition`：追加到查询区已组装的条件之后；**同 field 以宿主的为准**（先剔旧再追加），
+ *   这样宿主条件既不会被用户输入顶掉，也不会和用户输入同字段撞成两条。
+ * - 其余键：平铺覆盖（与改造前一致）。
+ * @param {Object} queryParams 查询表格已组装好的请求参数
+ * @param {Object} queryParam  宿主注入的查询参数
+ * @returns {Object} queryParams
+ */
+export function mergeQueryParam(queryParams, queryParam) {
+  if (!queryParams || !queryParam) return queryParams;
+
+  let hostCondition = normalizeCondition(queryParam.condition);
+  Object.keys(queryParam).forEach((key) => {
+    if (key !== "condition") queryParams[key] = queryParam[key];
+  });
+
+  if (!hostCondition.length) return queryParams;
+
+  let hostFields = hostCondition.map((item) => item.field);
+  let baseCondition = Array.isArray(queryParams.condition)
+    ? queryParams.condition.filter(
+        (item) => !item || hostFields.indexOf(item.field) < 0
+      )
+    : [];
+  queryParams.condition = baseCondition.concat(hostCondition);
+  return queryParams;
+}