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

package/package.json

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

package/src/components/formDialog/README.md

@@ -257,10 +257,13 @@ xform 整表模式下，底部按钮可在**表单设计器 → 表单设置 →
 - **resolve 语义**：配置了自定义按钮后 resolve `{ action: code, data }`；默认按钮仍是 `data`；取消/关闭仍是 `null`（存量调用不受影响）。
 - 调用方可传 `buttons: [...]`（同结构）覆盖模板配置；readonly 模式只显示"关闭"。
 - 弹框/抽屉共用同一套配置与语义（见下节 $formDrawer）。
-- **四个壳都吃这份配置**：全局 `$formDialog` / `$formDrawer`，以及表单脚本内部通道
-  `openFormDialog` / `openFormDrawer`（`xform/form-designer/form-widget/dialog/` 下那两个）。
-  一份模板配置，四处生效。内部通道收口时回调 `option.onAction(payload, formRef, vm)`
+- **三个壳都吃这份配置**：全局 `$formDialog` / `$formDrawer`，以及表单脚本内部弹框通道
+  `openFormDialog`（`xform/form-designer/form-widget/dialog/formDialog.vue`）。
+  一份模板配置，三处生效。内部通道收口时回调 `option.onAction(payload, formRef, vm)`
   （不传则仅按 `closeAfter` 关闭，不再走 `option.confirm`——按钮自身的 onClick 脚本即业务处理）。
+  > `openFormDrawer` 曾有一个同目录的内部抽屉壳，因零调用方且样式选择器写成 `.el-dialog__body`
+  > （el-drawer 下不匹配、内容区没高度）已删除；该方法现委托给全局 `$formDrawer`，
+  > 调用签名保持兼容，但 `bodyConfig` / `footerConfig` / `multiple` / `onAction` 四个字段不再生效。
 
 ## $formDrawer 表单抽屉
 
@@ -306,15 +309,38 @@ const result = await this.$formDrawer({
   显式传 `showFooter: true` 才出；`plain` / `select` / `actionButtons` 在此模式下不生效——
   抽屉只作视口，页内行为全部由宿主页负责。抽屉本身仍可 `await`，取消/关闭 resolve `null`。
 
-  表单脚本内部通道 `openFormDialog` / `openFormDrawer` 同样支持 `host: "list"`：
-  `this.openFormDrawer({ formCode: "xxx", host: "list", param: {...} })`。
+  表单脚本内部弹框通道 `openFormDialog` 同样支持 `host: "list"`。
   弹框形态嵌套层级更深（表单 → 弹框 → 列表页 → 详情），建议配 `dialogConfig: { fullscreen: true }`
-  或足够大的 width。若无历史包袱，表单脚本里直接调全局 `this.$formDrawer({ host: "list" })` 更轻。
+  或足够大的 width。抽屉形态直接调全局 `this.$formDrawer({ host: "list" })`
+  （`openFormDrawer` 也行，它就是这个方法的薄委托）。
 - **详情必传 `dataId`**：xform 的 `loadDefaultEntityData` 要 `formConfig.entity && dataId && 脚本编码` 三者齐全才发请求加载单据数据；只传 `conditionParam` 不会加载，表单会是空的。
 - **样式上下文**：抽屉内容区套了 `<div id="containt" class="designer-view">`，与 `views/user/form/vform/render.vue`、xform formDialog 一致。全站渲染态样式都挂在这两个钩子上（`style.scss` 的 `#containt .detail-wrap{...}` 与 `.preview-dialog,.designer-view{...}`），不套这层，详情场景会丢：头部右侧按钮的 inline-block（竖排换行）、`.d-item` 右侧 112px 的导航占位（模块导航压住数据表格）、`.detail-wrap` 的 `position:relative`（导航跑去锚 `.el-drawer`，被裁在抽屉外）、模块边框与内边距。
 - **表格铺满高度**：查询表格的 vxe-grid 用 `height="auto"`，按父元素实测高度计算，父链没有确定高度就会塌成一小块。抽屉不在全局 `.dialog-style .el-dialog__body .data-table_height` 选择器下，故由抽屉自己补高度链：模板顶层只有一个查询表格（`data-table` + `isQueryTable`）时自动开启；模板结构特殊（表格嵌在 tab/栅格里，或表单+表格混排）时用 `fillHeight: true/false` 手工指定，`true` 时被撑满的是渲染器根节点与 `.render-form`，表格外层容器仍需自身有高度。
 - 壳与 xform 渲染器均为懒加载（首次调用才加载），xform chunk 与 $formDialog 共享。
 
+## 设计器入口：点击绑定事件
+
+不写脚本也能打开这两个壳。设计器里选中按钮 / 链接 / 下拉项 / 搜索按钮 → 高级属性 →
+**点击绑定事件** → 「打开表单弹框」或「打开表单抽屉」，下方展开「表单弹框/抽屉配置」
+（存模板 JSON 的 `options.formHostConfig`，弹框与抽屉共用一份，互切不丢配置）。
+
+| 配置项 | 说明 |
+|---|---|
+| 表单编码 / 表单编码脚本 | 脚本优先，参数 `(dataId, formCode, rowData)` |
+| 以列表页承载 | 即 `host: "list"` |
+| 打开方式 | 新增（不传 dataId）/ 详情 |
+| 单据ID来源 | 当前控件值 / 指定表单字段 / 当前表格行字段 / 脚本。按钮类控件缺省用行字段（表格操作列场景） |
+| 自定义参数 | 脚本返回对象 → 壳的 `param` |
+| 只读 | 抽屉走 `readonly`（只读态、底部仅「关闭」）；弹框走 `disabledMode`（整表禁用、底部按钮不变） |
+| 形态 | 弹框：宽度 / 全屏；抽屉：素身详情 / 尺寸 / 弹出方向 |
+| 关闭后事件 | 参数 `(formRef, result)`。`result` 即壳的收口值——默认按钮是表单数据、配置按钮是 `{action, data}`、取消/关闭是 `null`，脚本据此决定要不要刷新宿主表格。抽屉侧 `formRef` 为 `null` |
+
+底部按钮不在这里配——由目标表单模板自己的 `formConfig.actionButtons` 决定（就是上一节那份配置）。
+该动作**不做数据回填、不做选择模式**：要回填/选行请用「打开选择弹框」。
+实现在 `xform/form-designer/setting-panel/property-editor/field-button/clickBindActions.js`
+（纯 JS 动作注册表，运行时与设计器共用），方案见
+`docs/点击绑定事件重构与表单弹框抽屉动作方案.md`。
+
 ## 与既有设施的分工
 
 | 场景 | 用什么 |

package/src/components/luckysheet/dialog.vue

@@ -136,7 +136,7 @@ export default {
         ::v-deep .grid-container {
           outline: none;
           &.detail-wrap .d-cont {
-            height: calc(100vh - 150px);
+            //height: calc(100vh - 150px);
             .title .field-wrapper {
               display: inline-block !important;
             }

package/src/components/wf/wfButtonName.js

@@ -0,0 +1,60 @@
+/**
+ * 流程按钮名：由后台 wf_diy_attribute 的 param18 统一维护，全局拉取一次后缓存。
+ * 接口返回形如 {submitBtn: "提交流程", saveSubmitBtn: "保存并提交流程"}，未配置时用下面的默认值。
+ */
+import Vue from "vue";
+
+export const DEFAULT_SUBMIT_BTN = "提交流程";
+export const DEFAULT_SAVE_SUBMIT_BTN = "保存并提交流程";
+
+/* 按钮通常先渲染、接口值后到，所以缓存必须是响应式的，读取方(computed)才能在值回来后自动重算。
+   初值留 null 是为了区分「后台没配」与「后台配的正好是默认值」——没配时才轮得到下游兜底。 */
+const wfButtonNames = Vue.observable({
+  submitBtn: null,
+  saveSubmitBtn: null,
+});
+
+let pending = null;
+
+export function getWfButtonNames() {
+  return wfButtonNames;
+}
+
+/**
+ * 拉取按钮名。全局只发一次请求，重复调用复用同一个 promise。
+ * @param {Object} vm 任意 Vue 实例(取 $http)，不传则退回 window.$vueRoot
+ */
+export function loadWfButtonNames(vm) {
+  if (pending) return pending;
+  let target = vm || window.$vueRoot;
+  if (!target || !target.$http) return Promise.resolve(wfButtonNames);
+  pending = new Promise((resolve) => {
+    target.$http({
+      url: USER_PREFIX + "/wf_diy_attribute/getValue",
+      method: "post",
+      data: { attributeKey: "param18" },
+      success: (res) => {
+        let val = res ? res.objx : null;
+        if (typeof val === "string") {
+          //后台可能存的是 JSON 文本，解析不出就当没配
+          try {
+            val = JSON.parse(val);
+          } catch (e) {
+            val = null;
+          }
+        }
+        if (val && typeof val === "object") {
+          wfButtonNames.submitBtn = val.submitBtn || null;
+          wfButtonNames.saveSubmitBtn = val.saveSubmitBtn || null;
+        }
+        resolve(wfButtonNames);
+      },
+      fail: () => resolve(wfButtonNames),
+      error: () => {
+        pending = null; //失败不锁死，下次进流程表单可重试
+        resolve(wfButtonNames);
+      },
+    });
+  });
+  return pending;
+}

package/src/components/xform/form-designer/designer.js

@@ -14,6 +14,7 @@ import {
   createUUID,
   columnFormatMap,
 } from "../../../components/xform/utils/util";
+import { CLICK_BIND } from "./setting-panel/property-editor/field-button/clickBindActions";
 import {
   containers,
   advancedFields,
@@ -1471,7 +1472,7 @@ let chartContainers = [],
           buttonCon3.options.label = "新增";
           buttonCon3.options.icon = "el-icon-search";
           // buttonCon3.options.onClick = "this.getWidgetRef('" + dataTableCon.options.name + "').addTableData();"
-          buttonCon3.options.clickBindEvent = "2";
+          buttonCon3.options.clickBindEvent = CLICK_BIND.ADD_TABLE_DATA;
           Object.assign(buttonCon3.options.addTableDataConfig, {
             tableRef: dataTableCon.options.name,
           });

package/src/components/xform/form-designer/form-widget/field-widget/fieldMixin.js

@@ -15,6 +15,10 @@ import {
 import FormValidators, {
   getRegExp,
 } from "../../../../../components/xform/utils/validators";
+import {
+  CLICK_BIND,
+  getClickBindAction,
+} from "../../setting-panel/property-editor/field-button/clickBindActions";
 import scriptHttpMixin from "../../../../../components/xform/mixins/scriptHttp";
 import defaultHandleMixin from "../../../../../components/xform/mixins/defaultHandle";
 
@@ -1311,34 +1315,52 @@ modules = {
         this.handleCustomClickEvent();
       }
     },
+    /**
+     * 点击绑定事件的上下文。链接模式（flag=true）下所有配置统一从
+     * widgetTextLinkConfig.options 读，不再出现「动作取链接的、前置脚本取主控件的」分裂。
+     */
+    getClickBindContext(flag) {
+      let linkOptions = this.field.options.widgetTextLinkConfig?.options;
+      let optionModel = flag ? linkOptions || {} : this.field.options;
+      return {
+        vm: this,
+        flag: !!flag,
+        field: this.field,
+        widgetType: this.field.type,
+        optionModel,
+        tableParam: this.tableParam,
+        rowData: this.tableParam?.row || null,
+        formRef: this.getFormRef(),
+        actionValue: optionModel.clickBindEvent,
+        // 链接模式优先用自己的前置脚本，未配则回落主控件（保持存量行为）
+        beforeScript:
+          optionModel.onBeforeClickButton
+          ?? this.field.options.onBeforeClickButton,
+      };
+    },
     handleCustomClickEvent: function (flag) {
-      let tableParam = this.tableParam;
-      let clickBindEvent = !flag
-        ? this.field.options.clickBindEvent
-        : this.field.options.widgetTextLinkConfig?.options?.clickBindEvent;
+      let ctx = this.getClickBindContext(flag);
+      let action = getClickBindAction(ctx.actionValue);
+      if (!action) return;
 
+      // done 幂等：脚本里调了 done() 又没 return false，也只执行一次
+      let fired = false;
       const done = () => {
-        if (clickBindEvent === "1") {
-          //打开选择弹框
-          this.openSearchDialog(tableParam, flag);
-        } else if (clickBindEvent === "2") {
-          //列表插入数据
-          this.handleAddTableDataEvent(flag);
-        }
+        if (fired) return;
+        fired = true;
+        action.run(ctx);
       };
-      if (clickBindEvent && this.field.options.onBeforeClickButton) {
-        if (
-          this.handleCustomEvent(
-            this.field.options.onBeforeClickButton,
-            ["done"],
-            [done]
-          ) !== false
-        ) {
-          done();
-        }
-      } else {
-        done();
+
+      if (!ctx.beforeScript) return done();
+      let ret = this.handleCustomEvent(ctx.beforeScript, ["done"], [done]);
+      if (ret === false) return; // 脚本显式接管
+      if (ret && typeof ret.then === "function") {
+        ret.then((result) => {
+          if (result !== false) done();
+        });
+        return;
       }
+      done();
     },
     handleAddTableDataEvent(flag) {
       let optionModel = !flag
@@ -1403,7 +1425,7 @@ modules = {
 
       let rows = [];
       if (this.hasVabsearchFlag()) {
-        if (this.field.options.multipleChoices) {
+        if (this.getMultipleChoices(flag)) {
           let fieldKeyName = this.fieldKeyName;
           let valueField = trim(this.field.options.valueField || fieldKeyName);
           let vabSearchName = trim(
@@ -1438,7 +1460,7 @@ modules = {
           formCode: formCode,
           rows,
           queryParam,
-          multiple: searchDialogConfig.multipleChoices || false,
+          multiple: this.getMultipleChoices(flag),
           confirm: (rows) => {
             this.handleConfirmSearchDialog(rows, false, flag);
           },
@@ -1448,14 +1470,28 @@ modules = {
       this.getFormRef().openSearchDialog(dialogParam);
     },
     handleClearSearchDialog() {
+      // 清除入口只存在于 vabsearch 主控件（onSearchClear），链接模式没有清除按钮
       let clickBindEvent = this.field.options.clickBindEvent;
-      if (clickBindEvent === "1") {
+      if (clickBindEvent === CLICK_BIND.SEARCH_DIALOG) {
         this.handleConfirmSearchDialog(null, true);
       }
     },
-    getMultipleChoices() {
-      let multipleChoices = this.field.options.multipleChoices;
-      return multipleChoices;
+    /**
+     * 「是否多选」唯一读取口径。
+     * 搜索类控件（vabsearch/singerSearch/multiSearch）的 multipleChoices 是结构性的
+     * ——它决定字段值是数组还是标量——所以以控件自身的为准；其它控件读选择弹框配置。
+     * 此前开弹框读 searchDialogConfig、回填读 field.options，两个开关不一致时会出现
+     * 「弹框能多选、回填只落一条」。
+     */
+    getMultipleChoices(flag) {
+      let optionModel = !flag
+        ? this.field.options
+        : this.field.options.widgetTextLinkConfig?.options || {};
+      return (
+        this.field.options.multipleChoices
+        ?? optionModel.searchDialogConfig?.multipleChoices
+        ?? false
+      );
     },
     hasVabsearchFlag() {
       return (

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

@@ -74,6 +74,9 @@ export default {
       if (this.designState) return true;
       const formRef = this.getFormRef();
       if (!formRef?.formConfig?.wfEnabled) return false;
+      // 配置优先：表单设置里已启用「保存并提交流程」内建按钮时，本遗留组件让位，
+      // 否则同一模板会出现两个按钮。组件本身保留，只为老模板兼容。
+      if (formRef.formConfig.saveSubmitEnabled === true) return false;
       if (this.isWfStarted(formRef)) return false;
       return !this.field.options.hidden;
     },

package/src/components/xform/form-designer/setting-panel/form-setting.vue

@@ -148,7 +148,11 @@
               class="draggable-box"
               v-if="actionButtons.length"
               :list="actionButtons"
-              v-bind="{ group: 'actionBtnGroup', ghostClass: 'ghost', handle: '.drag-option' }"
+              v-bind="{
+                group: 'actionBtnGroup',
+                ghostClass: 'ghost',
+                handle: '.drag-option',
+              }"
             >
               <li
                 v-for="(btn, btnIdx) in actionButtons"
@@ -189,6 +193,9 @@
           </el-form-item>
         </el-collapse-item>
         <el-collapse-item name="3" title="流程信息">
+          <!-- 分组按单据的流程生命周期排：基础 → 提交入口 → 提交动作 → 审批过程 → 高级。
+               「提交动作」组内的顺序即真实执行顺序：前置脚本 → 确认提示 → 启动时自动保存。 -->
+          <div class="wf-group-title">基础</div>
           <el-form-item :label="i18nt('启用流程')">
             <el-switch
               v-model="formConfig.wfEnabled"
@@ -219,8 +226,67 @@
               clearable
             ></el-input>
           </div>
-          <el-form-item :label="i18nt('流程启动时自动保存表单数据')">
-            <el-switch v-model="formConfig.wfStartBindSave"></el-switch>
+
+          <div class="wf-group-title">提交入口（按钮）</div>
+          <el-form-item v-if="formConfig.wfEnabled">
+            <span slot="label">
+              {{ i18nt("启用保存并提交流程") }}
+              <el-tooltip effect="light" placement="top">
+                <div slot="content" style="line-height: 1.6">
+                  详情页标题栏内建「保存并提交流程」按钮<br />
+                  只在新增页显示，编辑态、已启动流程的单据不显示<br />
+                  按钮名由后台流程自定义属性(param18)统一下发，此处不配
+                </div>
+                <i class="el-icon-info"></i>
+              </el-tooltip>
+            </span>
+            <el-switch v-model="formConfig.saveSubmitEnabled"></el-switch>
+          </el-form-item>
+          <el-form-item>
+            <span slot="label">
+              {{ i18nt("提交流程按钮显隐控制脚本") }}
+              <el-tooltip effect="light" placement="top">
+                <div slot="content" style="line-height: 1.6">
+                  控制详情页「提交流程」按钮显隐，return false
+                  隐藏，不配则显示<br />
+                  随表单数据实时求值，脚本内只读数据、返回布尔即可，切勿修改数据
+                </div>
+                <i class="el-icon-info"></i>
+              </el-tooltip>
+            </span>
+            <a
+              href="javascript:void(0);"
+              class="a-link link-oneLind"
+              @click="editFormEventHandler('wfStartBtnShow')"
+            >
+              <span>{{ formConfig.wfStartBtnShow }}</span>
+              <i class="el-icon-edit"></i>
+            </a>
+          </el-form-item>
+
+          <div class="wf-group-title">提交动作（按执行先后）</div>
+          <el-form-item>
+            <span slot="label">
+              {{ i18nt("提交前置处理脚本") }}
+              <el-tooltip effect="light" placement="top">
+                <div slot="content" style="line-height: 1.6">
+                  「提交流程」「保存并提交流程」共用<br />
+                  表单校验通过后、确认框之前执行<br />
+                  return false 中止提交；返回 Promise 则等它 resolve（false 或
+                  reject 同样中止）<br />
+                  入参 source：saveSubmit=保存并提交流程，wfStart=提交流程
+                </div>
+                <i class="el-icon-info"></i>
+              </el-tooltip>
+            </span>
+            <a
+              href="javascript:void(0);"
+              class="a-link link-oneLind"
+              @click="editFormEventHandler('onBeforeSubmitWf')"
+            >
+              <span>{{ formConfig.onBeforeSubmitWf }}</span>
+              <i class="el-icon-edit"></i>
+            </a>
           </el-form-item>
           <el-form-item :label="i18nt('流程启动确认提示脚本')">
             <a
@@ -232,7 +298,11 @@
               <i class="el-icon-edit"></i>
             </a>
           </el-form-item>
+          <el-form-item :label="i18nt('流程启动时自动保存表单数据')">
+            <el-switch v-model="formConfig.wfStartBindSave"></el-switch>
+          </el-form-item>
 
+          <div class="wf-group-title">审批过程</div>
           <el-form-item :label="i18nt('流程通过时自动保存表单数据')">
             <el-switch v-model="formConfig.wfAgreenBindSave"></el-switch>
           </el-form-item>
@@ -268,6 +338,8 @@
               <i class="el-icon-edit"></i>
             </a>
           </el-form-item>
+
+          <div class="wf-group-title">高级</div>
           <el-form-item :label="i18nt('引用流程的表单编码')">
             <el-input
               type="text"
@@ -286,7 +358,7 @@
           </el-form-item>
         </el-collapse-item>
         <el-collapse-item name="4" title="列表标签页信息（仅列表表单生效）">
-          <el-form-item>
+          <el-form-item label-width="0">
             <span style="color: #999; font-size: 12px; line-height: 1.6">
               本组配置只从「查询列表页」所用的表单读取，在详情/编辑表单里设置不会生效
             </span>
@@ -1081,6 +1153,8 @@ export default {
       eventDialogTitleMap: {
         globalConfig: "全局参数配置",
         wfStartConfirmText: "流程启动确认提示语配置",
+        onBeforeSubmitWf: "提交前置处理脚本配置",
+        wfStartBtnShow: "提交流程按钮显隐控制脚本配置",
         wfConfig: "流程自定义配置",
         onBeforeCreated: "表单创建前事件配置",
         onFormCreated: "表单创建事件配置",
@@ -1097,9 +1171,13 @@ export default {
         onFormMounted: "onFormMounted(dataId,formCode) {",
         onFormDataChange:
           "onFormDataChange(fieldName, newValue, oldValue, formModel, subFormName, subFormRowIndex) {",
-        wfStartConfirmText:
-          "wfStartConfirmText(dataId, formCode, formData) {",
-        wfConfig: "wfConfig(dataId, formCode, formData) {",
+        wfStartConfirmText: "wfStartConfirmText(dataId, formCode, formData) {",
+        onBeforeSubmitWf:
+          "onBeforeSubmitWf(dataId, formCode, formData, source) {",
+        /* 顺序以 indexMixin 的 new Function("formCode","dataId","formData") 为准，
+           不是其他脚本的 (dataId, formCode) 惯例——存量脚本按这个顺序写的，只改提示不动实参 */
+        wfConfig: "wfConfig(formCode, dataId, formData) {",
+        wfStartBtnShow: "wfStartBtnShow(dataId, formCode, formData) {",
         globalConfig: "globalConfig(dataId, formCode) {",
         //'onFormValidate':     'onFormValidate() {',
       },
@@ -1224,7 +1302,9 @@ $\{wf.starterName\}提交的$\{pm_product_project.product_code\}$\{pm_product_pr
     },
     editActionButton(index) {
       this.currentActionButtonIndex = index;
-      this.currentActionButton = deepClone(this.formConfig.actionButtons[index]);
+      this.currentActionButton = deepClone(
+        this.formConfig.actionButtons[index]
+      );
       this.showActionButtonDialog = true;
     },
     removeActionButton(index) {
@@ -1666,6 +1746,21 @@ $\{wf.starterName\}提交的$\{pm_product_project.product_code\}$\{pm_product_pr
   }
 }
 
+/* 折叠组内部的二级分组标题，用于把长配置组切成几段（如「流程信息」） */
+.wf-group-title {
+  margin: 14px 0 8px;
+  padding-left: 8px;
+  border-left: 3px solid #409eff;
+  color: #606266;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 1.3;
+
+  &:first-child {
+    margin-top: 2px;
+  }
+}
+
 .small-padding-dialog {
   ::v-deep .el-dialog__body {
     padding: 6px 15px 12px 15px;

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

@@ -47,7 +47,6 @@ export default {
     selectedWidget: Object,
     optionModel: Object,
   },
-  inject:['defaultClickBindEventConfig'],
   data(){
     return {
       dataDialogVisible:false,