cloud-web-corejs 1.0.54-dev.786 → 1.0.54-dev.788

package/src/components/formDrawer/index.js

@@ -0,0 +1,50 @@
+const modules = {};
+import vue from "vue";
+
+// 壳组件懒加载：首屏只留本入口几十行；抽屉壳（含 select 逻辑、按钮公共模块）
+// 随首次调用进独立 chunk，xform 渲染器与 formDialog 共享同一异步 chunk
+let FormDrawerCtor = null;
+
+function loadCtor() {
+  if (FormDrawerCtor) return Promise.resolve(FormDrawerCtor);
+  return import(
+    /* webpackChunkName: "form-drawer" */ "./drawer.vue"
+  ).then((m) => {
+    FormDrawerCtor = vue.extend(m.default);
+    return FormDrawerCtor;
+  });
+}
+
+/**
+ * JS 调用打开 formCode 抽屉。每次调用创建独立实例，支持叠开多层。
+ * options：{ formCode, title, size, direction, param, conditionParam, plain,
+ *           select: {multiple, rows, fieldKey, queryParam, onConfirm},
+ *           buttons, showFooter, readonly, onReady, beforeConfirm, model, ... }
+ * resolve：默认按钮下 select 模式返回选中行数组、表单模式返回表单数据；
+ * 配置了自定义按钮（formConfig.actionButtons / options.buttons）返回 {action, data}；
+ * 取消/关闭返回 null。详见 components/formDialog/README.md。
+ */
+function open(options = {}) {
+  return loadCtor().then((Ctor) => {
+    const parent
+      = typeof window !== "undefined" && window.$vueRoot ? window.$vueRoot : null;
+    const instanceOptions = {};
+    if (parent) {
+      instanceOptions.parent = parent;
+      if (parent._i18n) {
+        instanceOptions.i18n = parent._i18n;
+      }
+    }
+    const instance = new Ctor(instanceOptions);
+    instance.$mount();
+    document.body.appendChild(instance.$el);
+    return instance.open(options);
+  });
+}
+
+modules.install = function (Vue) {
+  Vue.prototype.$formDrawer = open;
+};
+modules.open = open;
+
+export default modules;

package/src/components/onlineTalk/talkUserDialog.vue

@@ -37,7 +37,7 @@
                 type="text"
                 status="primary"
                 plain
-                >{{ $t1("重置") }}
+                >{{ $t1("刷新") }}
               </vxe-button>
               <vxe-button
                 status="warning"

package/src/components/table/index.js

@@ -576,6 +576,10 @@ function initOption(opts) {
       types: ["xlsx", "csv", "html", "xml", "txt"],
       // 仅保留当前页：mode=all 依赖的 queryAll 无鉴权实现，从未可用；全量导出请走 $excelExport
       modes: ["current"],
+      // 与 $excelExport 一致地剔除非数据列与脱敏列，避免绕开 $excelExport 导出明文
+      columnFilterMethod({ column }) {
+        return !column.params?.exportDisabled;
+      },
     },
     radioConfig: {
       labelField: "id",

package/src/components/tempStorage/tempStorageDialog.vue

@@ -38,7 +38,7 @@
                 type="text"
                 status="primary"
                 plain
-                >{{ $t1("重置") }}
+                >{{ $t1("刷新") }}
               </vxe-button>
               <vxe-button
                 status="warning"

package/src/components/wf/addTaskUserdialog.vue

@@ -33,7 +33,7 @@
           <div class="clearfix screen-btns">
             <div class="fr">
               <vxe-button icon="el-icon-brush" class="button-sty" @click="resetEvent" type="text" status="primary"
-                          plain>{{ $t2('重置', 'system.button.reset') }}
+                          plain>{{ $t1('刷新') }}
               </vxe-button>
               <vxe-button status="warning" icon="el-icon-search" class="button-sty" @click="searchEvent">
                 {{ $t2('搜索', 'system.button.search') }}

package/src/components/xform/docs/2026-08 /345/210/227/350/241/250/345/257/274/345/207/272/350/204/261/346/225/217/345/210/227/345/211/224/351/231/244/350/220/275/345/234/260/346/226/207/346/241/243.md"

@@ -0,0 +1,165 @@
+# 列表导出脱敏列剔除（2026-08）
+
+> 起因：配置了「加密」（密文文本）的字段，页面显示 `138****1234`，导出 Excel 却是完整明文。
+> 排查范围：`src/components/xform/**`、`src/components/excelExport/**`、`src/components/table/**`。
+
+## 一、问题定性
+
+「加密」是**纯前端展示遮罩**，不是数据加密：
+
+- 配置入口：属性面板 `textFlag-editor.vue` → `options.userTextRuleEnabled` + `options.userTextRuleConfig[]`
+- 单条规则 `{ serveName, companyCodes, roleCodes, type, encryptFormula }`，`type=1` 角色不匹配时脱敏、`type=2` 角色匹配时脱敏，`encryptFormula` 形如 `3*3`
+- 改造前实现只有一处：`form-item-wrapper.vue` —— `created` → `initShowType()` 算出 `widgetTextFlag=2`，模板改渲染 `<span>{{ getShowValue() }}</span>`，`getShowValue()` → `getProcessText()` 做星号替换
+
+**原始值始终完整存在于 `row[field]` / `fieldModel` 中**，遮罩只发生在渲染层。
+
+## 二、根因：导出取值绕开渲染层
+
+导出取值优先级（`excelExport/mixins.js:828 getExportCellValue`）：
+
+1. `column.params.exportVal`
+2. **`column.slots.filterVal(params)`** ← 命中点
+3. 无自定义渲染 → `row[field]`（有 `formatter` 则格式化）
+4. 兜底 `getCellValue()`：挂载 vNode 渲染再爬 DOM
+
+而 `data-table-mixin.js:1888` 对 `input / number / text / select / checkbox / radio / status / vabsearch / date / textarea / a-link / a-text` 这 12 类组件列统一注册了 `col.slots.filterVal`，函数体直接返回 `row[field]`（select/radio/checkbox 返回 optionLabel，vabsearch 返回 label 字段，date 返回格式化值）——**整条路径不碰 `form-item-wrapper`，不读 `widgetTextFlag`**。
+
+这 12 类恰好是最常配脱敏的字段类型。副作用是不一致：不在这 12 类里的组件列（`slots.default = "widget"`，无 `filterVal`）走第 4 条兜底，会真实渲染 wrapper 并爬 DOM，**导出的反而是星号**。同一张表有的列明文、有的列打码，且非有意设计。
+
+其它同源泄漏点：
+
+| 路径 | 改造前 |
+|---|---|
+| 明细导出（`exportItemColumns`，`data-table-mixin.js:2406`） | 必明文：列只有 `field/title`，行数据后端原样返回 |
+| 条件导出 / 全量导出 | 明文：`loopToDo` 分页拉后端原始行 → 同一个 `getExcelData` |
+| H5 列表容器 `list-h5-item.vue` | 明文：独立 `exportData`，列带 `params.widget` 但无 `filterVal` |
+| vxe 工具栏自带导出（`table/index.js` `exportConfig`） | 明文：vxe 用行原始值 |
+| 列筛选下拉候选值（`vxeFilter/mixin.js`） | 明文（不属导出，本轮未处理） |
+| 接口响应 / JS 内存 | 明文（需后端脱敏，前端不可解） |
+
+## 三、方案选型
+
+| 档位 | 做法 | 结论 |
+|---|---|---|
+| 1 | 前端一致性：给 `filterVal` 结果也套一层遮罩 | 未选。要同步改 4 处取值路径，且"导出打码值"对下游数据消费无意义 |
+| **2** | **命中脱敏规则的列直接整列不导出** | **本次采用** |
+| 3 | 后端按角色脱敏返回 / 提供脱敏导出接口 | 真正解法，本轮范围外。方案 1、2 都只是"看不见"，不是"拿不到" |
+
+方案 2 之所以成立：**所有导出（列表 / 条件 / 选择 / 明细）都必须先过 `exportFieldDialog`**（`mixins.js:133` 是唯一入口，`:1072` 回传 columns/leafColumns），而 `params.exportDisabled` 已被三处消费：
+
+| 位置 | 效果 |
+|---|---|
+| `exportFieldDialog.vue:95 filterNonDataExportColumns`（`:160` 调用） | 字段选择树里不出现该列，子列全没了则父分组也去掉 |
+| `exportFieldDialog.vue:319 dialogConfirm→loopDo` | 生成表头 JSON 时跳过 |
+| `excelExport/mixins.js:860 getExcelData` | 取数时过滤 `leafColumns` |
+
+所以只要把标记打到列上即可一次收口，无需改任何取值逻辑。
+
+> 曾评估过变体「保留表头、值置空」：需给通用 `excelExport` 新增 `exportMasked` 语义，且整列空白易被下游误读成"该记录无值"，已否决。
+
+## 四、改动清单
+
+### 1. 新增 `src/components/xform/utils/textMaskUtil.js`
+
+脱敏判定的**唯一实现**，渲染侧与导出侧共用（否则界面打码、导出放行必然漂移）。
+
+| 导出 | 职责 |
+|---|---|
+| `resolveTextMaskFlag(widgetOptions, ctx)` | 判定是否脱敏 + 带出命中的 `encryptFormula` |
+| `compareToList(list1, list2)` | 编码列表匹配，空列表表示不限 |
+| `hasTextMaskRule(widgetOptions)` | 是否配了有效规则（不代表当前用户命中） |
+| `buildTextMaskContext(formRef, companyCode)` | 组装 `{ bdService, companyCode, roleCodeList }` |
+| `isTextMaskContextReady(ctx)` | 上下文是否就绪 |
+| `markMaskedExportColumns($grid, ctx)` | 给命中列打 `params.exportDisabled`，并同步到明细导出列 |
+
+判定逻辑逐行照搬原 `initShowType`，包括两个易被"优化"掉的细节：
+
+- 规则列表**全遍历而非命中即止**，后置规则会覆盖前置结论；
+- `encryptFormula` 只要 serveName/companyCodes 命中就赋值，与 masked 与否无关。
+
+### 2. `form-item-wrapper.vue:676 initShowType`
+
+保留两个早退外壳（`!!this.designer`、`isLoadEntity && !dataId`）与 `field.options.widgetTextFlag` 写回，中间判定改调 util。行为等价，净减 73 行。
+
+`compareToList` 保留为薄封装委托 util —— 本包对外发布，不删以免破坏下游调用。
+
+### 3. `data-table-mixin.js`
+
+- `:3231 markMaskedColumnsForExport()` —— 3 行委托 util
+- `:3245 exportData()` 入口调用
+- `:253 mounted` 建列后 `$nextTick` 再调一次（见下节决策 3）
+
+### 4. `list-h5-item.vue:1664 / :1671`
+
+H5 列表容器有独立 `exportData`，同样处理。这是编码阶段才发现的第二条泄漏路径。
+
+### 5. `components/table/index.js:580`
+
+`exportConfig` 增加 `columnFilterMethod`，堵 vxe 工具栏自带导出旁路。
+
+**行为变化**：原有的操作列、图片列等 `exportDisabled` 列也会从原生导出中消失。属修正，但需业务知晓。
+
+### 6. `tests/unit/components/xform/textMaskUtil.spec.js`
+
+17 个用例，覆盖规则匹配的各分支、fail-closed、自愈还原、分组表头递归、明细列对齐。
+
+## 五、关键设计决策
+
+**决策 1 —— 判定放在导出触发时，不放在建列时。**
+`bdService` / `userRoleDTOs` 由异步接口填充（`form-render/indexMixin.js:458、479、498`），建列时可能尚未就绪。
+
+**决策 2 —— 上下文未就绪时 fail-closed。**
+`compareToList` 在角色列表为空时返回 false → 被判成"角色不匹配"：对 `type=1` 规则偏保守（判为脱敏，安全），但对 `type=2` 规则会判成**不脱敏**，正好是危险方向。故上下文未就绪时，凡 `hasTextMaskRule` 为真的列一律剔除。
+
+**决策 3 —— `mounted` 也标记一次。**
+vxe 原生导出不走 `exportData()`，若只在导出入口标记，`columnFilterMethod` 会拿到一张没标记的列表，等于没堵。建列后立刻按 fail-closed 打标，之后每次 `exportData` 自愈修正。用户先点 $excelExport 再点原生导出的顺序也天然安全。
+
+**决策 4 —— 标记幂等且可自愈，用私有键区分归属。**
+`exportDisabled` 也可能是 `isNonDataExportColumn`（`data-table-mixin.js:1710`）打的。若无差别地 `delete`，自愈会误放行操作列。故引入 `MASK_MARK_KEY = "exportDisabledByTextMask"`（`textMaskUtil.js:19`）：
+
+- 列本就带 `exportDisabled` 且无私有键 → 不接管，不打私有键
+- 由本函数从无到有打上 → 同时写私有键
+- 撤销时只在私有键存在时才删
+
+## 六、覆盖范围
+
+| 泄漏点 | 现状 |
+|---|---|
+| 列表导出 / 条件导出 / 选择导出 | ✅ 堵住 |
+| H5 列表导出 | ✅ 堵住 |
+| 明细导出 | ⚠️ 按 field 名对齐，见局限 L1 |
+| vxe 工具栏原生导出 | ✅ 决策 3 + 改动 5 |
+| 列筛选下拉候选值明文 | ❌ 未纳入（不属导出） |
+| 接口响应 / JS 内存明文 | ❌ 需后端脱敏 |
+| 打印 / PDF | 走 DOM，应是打码的，**未验证** |
+| 单元格区域复制 | **未验证**，疑似明文 |
+
+## 七、已知局限
+
+- **L1**：明细导出列只有 `field/title`，只能按字段名匹配主表脱敏字段集合。明细独有字段、或明细导出脚本返回的字段名与主表不一致时，仍会明文导出。
+- **L2**：动态列 / 行级 schema（`fieldSchemaMap`）下同列不同行配置可能不同，判定按列模板走；模板未配、个别行配了的情况会漏。
+- **L3**：表单低代码脚本里直接读 `row.xxx`、或列上配了自定义 `params.exportVal` 的，不受影响。
+- **L4**：脱敏是**列级**判定；将来若出现行级脱敏，本方案不适用。
+- **L5**：`exportFieldDialog.addTableExportColumns()`（`:252`）会把勾选状态持久化到 `$grid.exportColumns`。脱敏列不在树里 → 记为 `export:false`。同一用户换成不脱敏角色后，该列默认不勾选，需手动勾一次。
+
+## 八、验证情况
+
+已验证：
+
+- `npx jest`：13 套 156 个用例全过（新增 17 个）
+- ESLint：新增文件 0 error；改动文件只剩改动前就存在的既有错误（全库 132 个，`npm run lint` 本就不通过）
+
+**未做真机联调**，以下回归项待验：
+
+1. 配了脱敏的字段列，四种导出（列表 / 条件 / 选择 / 明细）文件中均无该列；
+2. 两种规则方向：`type=2 + 角色匹配`、`type=1 + 角色不匹配`；
+3. 未配脱敏的列完全不受影响；
+4. **分组表头 2 层 / 3 层下剔除叶子列后表头不错位**（`loopDo` 会重算 `colSpan/rowSpan`，本轮风险最高的一处）；
+5. 用户信息接口未返回时立即点导出 → 走 fail-closed 而非明文导出；
+6. 页面遮罩显示效果与改造前一致（验证 `initShowType` 重构无回归）；
+7. vxe 工具栏导出（若宿主开启了该按钮）。
+
+## 九、同步提示
+
+- `textMaskUtil.js` 属包内新增文件，海尔分支（stdxx）整体覆盖时需一并带上，否则 `form-item-wrapper.vue` 与两个容器的 import 会解析失败；
+- 改动 5 落在 `components/table/index.js`（通用表格默认配置），影响面超出 xform，同步时注意与分支上的本地修改合并。

package/src/components/xform/form-designer/form-widget/container-widget/data-table-widget.vue

@@ -65,7 +65,7 @@
               <div class="fr">
                 <!-- <vxe-button icon="el-icon-view" class="button-sty" @click="searchEvent">显示总记录数</vxe-button> -->
                 <vxe-button icon="el-icon-brush" class="button-sty" @click="resetEvent" type="text" status="primary"
-                            plain>重置
+                            plain>刷新
                 </vxe-button>
 
                 <vxe-button status="warning" icon="el-icon-search" class="button-sty" @click="searchEvent">搜索

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

@@ -6,7 +6,16 @@
     v-bind="dialogConfig"
     @close="close"
   >
-    <div class="cont designer-view" v-bind="bodyConfig" id="containt">
+    <!-- host:"list" —— 承载列表宿主页（自带「常规(详情)/列表」页签），行点击进详情等行为与整页一致。
+         list.vue 根节点自带 #containt，本分支不再套 id，避免嵌套重复。 -->
+    <div
+      class="cont designer-view fd-list-host"
+      v-bind="bodyConfig"
+      v-if="listHost"
+    >
+      <list-view-host :formCode="listFormCode" :param="dialogParam" />
+    </div>
+    <div class="cont designer-view" v-bind="bodyConfig" id="containt" v-else>
       <v-form-render
         :form-json.sync="formJson"
         :form-data="formData"
@@ -22,6 +31,7 @@
         v-bind="formConfig"
         :param="dialogParam"
         class="data-table_height"
+        @hook:mounted="handleFormMounted"
       />
     </div>
     <span
@@ -34,7 +44,27 @@
         <i class="el-icon-close el-icon"></i>
         {{ $t2("取 消", "system.button.cancel2") }}
       </el-button>
-      <el-button type="primary" @click="dialogSubmit" class="button-sty" v-if="confirmButtonVisible">
+      <!-- 模板配了 formConfig.actionButtons 时，用配置按钮替代「确定」（取消保持不变） -->
+      <template v-if="visibleFooterButtons">
+        <el-button
+          v-for="btn in visibleFooterButtons"
+          :key="btn.code"
+          :type="btn.type || 'primary'"
+          :plain="btn.plain === true"
+          class="button-sty"
+          :loading="!!btnLoadingMap[btn.code]"
+          @click="handleActionButton(btn)"
+        >
+          <i v-if="btn.icon" :class="[btn.icon, 'el-icon']"></i>
+          {{ btnLabel(btn) }}
+        </el-button>
+      </template>
+      <el-button
+        v-else-if="confirmButtonVisible"
+        type="primary"
+        @click="dialogSubmit"
+        class="button-sty"
+      >
         <i class="el-icon-check el-icon"></i>
         {{ $t2("确 定", "system.button.confirm2") }}
       </el-button>
@@ -44,9 +74,22 @@
 
 <script>
 import VFormRender from "../../../../../components/xform/form-render/index.vue";
+import {
+  resolveActionButtons,
+  hasButtonPermission,
+  isButtonVisible,
+  runActionButton,
+} from "@base/components/formDialog/actionButtons";
 
 export default {
-  components: { VFormRender },
+  components: {
+    VFormRender,
+    // 列表宿主页（x-tabs：常规/列表/其他页签/多标签编辑），仅 host:"list" 时加载
+    ListViewHost: () =>
+      import(
+        /* webpackChunkName: "form-list-host" */ "@base/views/user/form/view/list.vue"
+      ),
+  },
   props: {
     visiable: Boolean,
     option: Object,
@@ -76,7 +119,11 @@ export default {
       currentLayoutType: null,
       dataId: null,
       formConfig: {},
-      confirmButtonVisible: true
+      confirmButtonVisible: true,
+      // 模板 formConfig.actionButtons（权限过滤后）；为空则底部保持默认「确定」
+      customButtons: null,
+      btnLoadingMap: {},
+      formRefMounted: false,
     };
   },
   computed: {
@@ -86,6 +133,13 @@ export default {
     dialogParam() {
       return this.option?.param;
     },
+    // host:"list" —— 用列表宿主页承载（带「常规/列表」页签），而非直接渲染单个表单
+    listHost() {
+      return this.option?.host === "list";
+    },
+    listFormCode() {
+      return this.option?.formCode;
+    },
     /* formConfig() {
       return this.option?.formConfig;
     }, */
@@ -107,6 +161,15 @@ export default {
       config.title = this.$t1(config.title);
       return config;
     },
+    // 自定义按钮渲染列表：权限已在 initCustomButtons 过滤，此处按 visible 脚本过滤
+    visibleFooterButtons() {
+      if (!this.customButtons || !this.customButtons.length) return null;
+      this.formRefMounted; // eslint-disable-line no-unused-expressions
+      let buttons = this.customButtons.filter((btn) =>
+        isButtonVisible(btn, this.$refs.vFormRef)
+      );
+      return buttons.length ? buttons : null;
+    },
     bodyConfig() {
       let config = {};
       let classStr = this.currentLayoutType;
@@ -131,6 +194,8 @@ export default {
     this.currentLayoutType = currentFormConfig.layoutType;
 
     this.selectMulti = this.option.multiple ?? true;
+    // 列表宿主页自己会加载模板；仅在未指定标题时补取一次模板名做弹框标题
+    if (this.listHost && this.option.dialogConfig?.title) return;
     this.getReportTemplate();
   },
   methods: {
@@ -162,6 +227,8 @@ export default {
         success: (res) => {
           let formTemplate = res.objx || {};
           this.formTemplate = formTemplate;
+          // 列表宿主模式：只借模板名做标题，渲染与按钮均由宿主页自己负责
+          if (this.listHost) return;
           this.formJson = formTemplate.formViewContent
             ? JSON.parse(formTemplate.formViewContent)
             : {};
@@ -170,11 +237,47 @@ export default {
           if (formConfig.searchDialogUniqueField) {
             this.fieldKey = formConfig.searchDialogUniqueField;
           }
+          this.initCustomButtons(formConfig);
 
           this.showRender = true;
         },
       });
     },
+    // 模板 actionButtons：option.buttons 可覆盖；权限 formCode:authName 在此一次性过滤
+    initCustomButtons(formConfig) {
+      let buttons = resolveActionButtons(this.option?.buttons, formConfig);
+      this.customButtons = buttons
+        ? buttons.filter((btn) => hasButtonPermission(btn, this.formCode, this))
+        : null;
+    },
+    handleFormMounted() {
+      this.formRefMounted = true;
+    },
+    btnLabel(btn) {
+      return this.$t1 ? this.$t1(btn.label) : btn.label;
+    },
+    /**
+     * 自定义按钮点击：校验 → onClick 脚本 → done/closeAfter 收口。
+     * 收口时优先回调 option.onAction(payload, formRef, vm)；
+     * 未提供则仅按 closeAfter 关闭（按钮自身脚本即业务处理，不再走 option.confirm）。
+     */
+    handleActionButton(btn) {
+      let formRef = this.$refs.vFormRef;
+      if (!formRef || this.btnLoadingMap[btn.code]) return;
+      this.$set(this.btnLoadingMap, btn.code, true);
+      let clearLoading = () => this.$set(this.btnLoadingMap, btn.code, false);
+      runActionButton(btn, {
+        formRef,
+        host: this,
+        getSelection: () => [],
+        onSettle: (payload, close) => {
+          if (typeof this.option.onAction === "function") {
+            this.option.onAction(payload, formRef, this);
+          }
+          if (close) this.close();
+        },
+      }).then(clearLoading, clearLoading);
+    },
     close() {
       let formRef = this.$refs.vFormRef;
       this.showDialog = false;
@@ -206,6 +309,14 @@ export default {
 .list-dialog {
   .el-dialog__body {
     height: calc(100% - 42px);
+    // host:"list"：.cont 已有确定高度，把它传给 list.vue 根节点 #containt，
+    // .tab-box 自身是 height:100%，父链没高度页签内容区会塌成一条
+    .cont.fd-list-host {
+      padding: 0;
+      ::v-deep > #containt {
+        height: 100%;
+      }
+    }
     .cont {
       height: calc(100vh - 210px);
 

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

@@ -1,18 +1,32 @@
 <template>
   <el-drawer v-bind="dialogConfig" @close="close" :visible.sync="showDialog">
-    <div class="cont" v-bind="bodyConfig" id="containt">
+    <!-- host:"list" —— 承载列表宿主页（自带「常规(详情)/列表」页签），行点击进详情等行为与整页一致。
+         list.vue 根节点自带 #containt，本分支不再套 id，避免嵌套重复。 -->
+    <div class="cont fd-list-host" v-bind="bodyConfig" v-if="listHost">
+      <list-view-host :formCode="listFormCode" :param="dialogParam"/>
+    </div>
+    <div class="cont" v-bind="bodyConfig" id="containt" v-else>
       <v-form-render :form-json.sync="formJson" :form-data="formData" :option-data="optionData" ref="vFormRef"
                      :reportTemplate.sync="formTemplate" :conditionParam.sync="conditionParam"
                      :formInsData.sync="formInsData" v-if="showRender" visible-key="showRender" :parent-target="_self"
                      @reload="reload" :param="dialogParam"
-                     class="data-table_height"/>
+                     class="data-table_height" @hook:mounted="handleFormMounted"/>
     </div>
     <span class="dialog-footer" v-if="option.showFooter!==false" v-bind="option.footerConfig">
 			<el-button type="primary" plain class="button-sty" @click="close">
 				<i class="el-icon-close el-icon"></i>
 				{{ $t2('取 消', 'system.button.cancel2') }}
 			</el-button>
-			<el-button type="primary" @click="dialogSubmit" class="button-sty">
+			<!-- 模板配了 formConfig.actionButtons 时，用配置按钮替代「确定」（取消保持不变） -->
+			<template v-if="visibleFooterButtons">
+				<el-button v-for="btn in visibleFooterButtons" :key="btn.code" :type="btn.type || 'primary'"
+									 :plain="btn.plain === true" class="button-sty" :loading="!!btnLoadingMap[btn.code]"
+									 @click="handleActionButton(btn)">
+					<i v-if="btn.icon" :class="[btn.icon, 'el-icon']"></i>
+					{{ btnLabel(btn) }}
+				</el-button>
+			</template>
+			<el-button v-else type="primary" @click="dialogSubmit" class="button-sty">
 				<i class="el-icon-check el-icon"></i>
 				{{ $t2('确 定', 'system.button.confirm2') }}
 			</el-button>
@@ -22,9 +36,22 @@
 
 <script>
 import VFormRender from "../../../../../components/xform/form-render/index.vue";
+import {
+  resolveActionButtons,
+  hasButtonPermission,
+  isButtonVisible,
+  runActionButton,
+} from "@base/components/formDialog/actionButtons";
 
 export default {
-  components: {VFormRender},
+  components: {
+    VFormRender,
+    // 列表宿主页（x-tabs：常规/列表/其他页签/多标签编辑），仅 host:"list" 时加载
+    ListViewHost: () =>
+      import(
+        /* webpackChunkName: "form-list-host" */ "@base/views/user/form/view/list.vue"
+      ),
+  },
   props: {
     visiable: Boolean,
     option: Object
@@ -52,7 +79,11 @@ export default {
       conditionParam: null,
       formInsData: null,
       $grid: null,
-      currentLayoutType: null
+      currentLayoutType: null,
+      // 模板 formConfig.actionButtons（权限过滤后）；为空则底部保持默认「确定」
+      customButtons: null,
+      btnLoadingMap: {},
+      formRefMounted: false
     };
   },
   computed: {
@@ -62,6 +93,13 @@ export default {
     dialogParam() {
       return this.option?.param;
     },
+    // host:"list" —— 用列表宿主页承载（带「常规/列表」页签），而非直接渲染单个表单
+    listHost() {
+      return this.option?.host === "list";
+    },
+    listFormCode() {
+      return this.option?.formCode;
+    },
     dialogConfig() {
       let customClass = "dialog-style list-dialog dialog-checkbox pd_0";
       if (this.option.dialogConfig?.customClass) {
@@ -83,6 +121,15 @@ export default {
       config.title = this.$t1(config.title);
       return config;
     },
+    // 自定义按钮渲染列表：权限已在 initCustomButtons 过滤，此处按 visible 脚本过滤
+    visibleFooterButtons() {
+      if (!this.customButtons || !this.customButtons.length) return null;
+      this.formRefMounted; // eslint-disable-line no-unused-expressions
+      let buttons = this.customButtons.filter((btn) =>
+        isButtonVisible(btn, this.$refs.vFormRef)
+      );
+      return buttons.length ? buttons : null;
+    },
     bodyConfig() {
       let config = {};
       let classStr = this.currentLayoutType
@@ -101,6 +148,8 @@ export default {
     this.currentLayoutType = currentFormConfig.layoutType
 
     this.selectMulti = this.option.multiple ?? true;
+    // 列表宿主页自己会加载模板；仅在未指定标题时补取一次模板名做抽屉标题
+    if (this.listHost && this.option.dialogConfig?.title) return;
     this.getReportTemplate();
   },
   methods: {
@@ -130,12 +179,15 @@ export default {
         success: res => {
           let formTemplate = res.objx || {};
           this.formTemplate = formTemplate;
+          // 列表宿主模式：只借模板名做标题，渲染与按钮均由宿主页自己负责
+          if (this.listHost) return;
           this.formJson = formTemplate.formViewContent ? JSON.parse(formTemplate.formViewContent) : {};
           this.layoutType = this.formJson.formConfig.layoutType
           let formConfig = this.formJson.formConfig;
           if (formConfig.searchDialogUniqueField) {
             this.fieldKey = formConfig.searchDialogUniqueField;
           }
+          this.initCustomButtons(formConfig);
 
           this.showRender = true;
 
@@ -143,6 +195,41 @@ export default {
         }
       });
     },
+    // 模板 actionButtons：option.buttons 可覆盖；权限 formCode:authName 在此一次性过滤
+    initCustomButtons(formConfig) {
+      let buttons = resolveActionButtons(this.option?.buttons, formConfig);
+      this.customButtons = buttons
+        ? buttons.filter((btn) => hasButtonPermission(btn, this.formCode, this))
+        : null;
+    },
+    handleFormMounted() {
+      this.formRefMounted = true;
+    },
+    btnLabel(btn) {
+      return this.$t1 ? this.$t1(btn.label) : btn.label;
+    },
+    /**
+     * 自定义按钮点击：校验 → onClick 脚本 → done/closeAfter 收口。
+     * 收口时优先回调 option.onAction(payload, formRef, vm)；
+     * 未提供则仅按 closeAfter 关闭（按钮自身脚本即业务处理，不再走 option.confirm）。
+     */
+    handleActionButton(btn) {
+      let formRef = this.$refs.vFormRef;
+      if (!formRef || this.btnLoadingMap[btn.code]) return;
+      this.$set(this.btnLoadingMap, btn.code, true);
+      let clearLoading = () => this.$set(this.btnLoadingMap, btn.code, false);
+      runActionButton(btn, {
+        formRef,
+        host: this,
+        getSelection: () => [],
+        onSettle: (payload, close) => {
+          if (typeof this.option.onAction === "function") {
+            this.option.onAction(payload, formRef, this);
+          }
+          if (close) this.close();
+        },
+      }).then(clearLoading, clearLoading);
+    },
     close() {
       let formRef = this.$refs.vFormRef;
       this.showDialog = false;
@@ -172,6 +259,16 @@ export default {
   .el-dialog__body {
     height: calc(100% - 42px);
 
+    // host:"list"：.cont 已有确定高度，把它传给 list.vue 根节点 #containt，
+    // .tab-box 自身是 height:100%，父链没高度页签内容区会塌成一条
+    .cont.fd-list-host {
+      padding: 0;
+
+      ::v-deep > #containt {
+        height: 100%;
+      }
+    }
+
     .cont {
       height: calc(100vh - 210px);
 

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

@@ -27,7 +27,7 @@
           <div class="clearfix screen-btns">
             <div class="fr">
               <vxe-button icon="el-icon-brush" class="button-sty" @click="resetEvent" type="text" status="primary"
-                          plain>重置
+                          plain>刷新
               </vxe-button>
               <vxe-button status="warning" icon="el-icon-search" class="button-sty" @click="searchEvent">搜索</vxe-button>
             </div>

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

@@ -27,7 +27,7 @@
           <div class="clearfix screen-btns">
             <div class="fr">
               <vxe-button icon="el-icon-brush" class="button-sty" @click="resetEvent" type="text" status="primary"
-                          plain>重置
+                          plain>刷新
               </vxe-button>
               <vxe-button status="warning" icon="el-icon-search" class="button-sty" @click="searchEvent">搜索</vxe-button>
             </div>