cloud-web-corejs 1.0.54-dev.702 → 1.0.54-dev.704

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.0.54-dev.702",
+  "version": "1.0.54-dev.704",
   "scripts": {
     "dev": "vue-cli-service serve",
     "lint": "eslint --ext .js,.vue src",

package/src/components/xform/docs//345/220/216/345/217/260/345/255/227/346/256/265/357/274/210/345/212/250/346/200/201/347/224/237/346/210/220/357/274/211JSON /350/257/264/346/230/216.md"

@@ -1,8 +1,8 @@
 # 后台字段（动态生成）JSON 说明
 
 > 适用场景：
-> - 表格布局容器（`table`）启用 **后台字段（动态生成）**（`dynamicSchemaEnabled`）
-> - 数据表格（`data-table`）启用 **接口动态列**（`dynamicColumnSourceType: api`）
+> - 表格布局容器（`table`）启用 **动态字段**（`dynamicSchemaSourceType` 为 `script` 或 `api`）
+> - 数据表格（`data-table`）启用 **接口动态列**（`dynamicColumnSourceType: api`）或 **前端列脚本**（`script`）
 >
 > 二者共用同一套请求/响应与字段定义 JSON 格式（见 `utils/dynamicSchemaUtil.js`）。
 >
@@ -15,14 +15,28 @@
 ## 1. 调用流程
 
 ```
-表单渲染
-  → table 容器请求 dynamicSchemaScriptCode 脚本
-  → 解析响应为「字段定义数组」
-  → 按生成模式(append/replace/anchor)插入行布局
+table mounted
+  → 加载条件脚本（可选）
+  → script：执行 dynamicSchemaScript
+  → api：请求 dynamicSchemaScriptCode
+  → 解析 objx → 按 dynamicSchemaMode 插入行布局
   → 各字段控件初始化（下拉/状态等可能再次请求选项数据）
   → （业务需要时）脚本调用 loadDynamicSchema() 重新加载，见 §1.5
 ```
 
+| 设计器配置 | 属性名 |
+|-----------|--------|
+| 动态字段来源 | `dynamicSchemaSourceType`：`none` / `script` / `api` |
+| 前端字段脚本 | `dynamicSchemaScript` |
+| 脚本编码 | `dynamicSchemaScriptCode` |
+| 额外参数 | `dynamicSchemaScriptParam` |
+| 转换脚本 | `dynamicSchemaConvert` |
+| 加载条件 | `dynamicSchemaLoadScript` |
+| 生成模式 | `dynamicSchemaMode`：`append` / `replace` / `anchor` |
+
+> 设计器入口：选中 **table 容器** → 属性面板 **动态字段** 区块（布局与数据表格「列与动态列」一致）。  
+> 旧表单若仍含 `dynamicSchemaEnabled: true`，运行时按 `api` 模式兼容。
+
 ### 1.1 请求参数（前端 → 后台字段脚本）
 
 ```json
@@ -38,7 +52,7 @@
 | 字段 | 说明 |
 |------|------|
 | `formData` | 当前表单数据（`formModel`），固定传入 |
-| 其余字段 | 由容器属性「脚本返回对应的参数值」脚本动态返回 |
+| 其余字段 | 由容器属性「额外参数」脚本动态返回 |
 
 ### 1.2 响应外层结构
 
@@ -57,7 +71,7 @@
 | 优先级 | 结构 | 场景 |
 |--------|------|------|
 | 1 | `objx` 为数组 | 通用 |
-| 2 | `objx.fields` 为数组 | 表头后台字段 |
+| 2 | `objx.fields` 为数组 | 表头动态字段 |
 | 3 | `objx.columns` 为数组 | 数据表格动态列 |
 
 配置了 **转换脚本** `dynamicSchemaConvert` 时，入参为完整 `res`，需返回数组或 `{ fields: [...] }` / `{ columns: [...] }`。
@@ -70,9 +84,9 @@
 
 **数据表格专用文档（含各列类型完整示例）：** [`数据表格动态列 JSON 说明.md`](./数据表格动态列%20JSON%20说明.md)
 
-### 1.5 脚本重新加载（表头后台字段）
+### 1.5 脚本重新加载（表头动态字段）
 
-首次加载在 `table` 容器 `mounted` 时自动执行。主表数据或业务条件变化后，需在脚本里**手动**调用以重新请求后台并刷新字段。
+首次加载在 `table` 容器 `mounted` 时自动执行（可通过 `dynamicSchemaLoadScript` 控制是否加载）。主表数据或业务条件变化后，需在脚本里**手动**调用以重新加载字段。
 
 **任意字段 / 按钮脚本（写法相同）：**
 
@@ -95,9 +109,11 @@ this.getWidgetRef("headerTable").loadDynamicSchema().then(() => {
 |------|------|
 | 方法 | `loadDynamicSchema()` |
 | 挂载组件 | `table-item`（`dynamicFieldMixin.js`） |
-| 行为 | 删除上次动态生成的行 → 用当前 `formModel` +「脚本返回对应的参数值」重新请求 → 按 `dynamicSchemaMode` 插入 |
+| `api` 模式 | 重新请求 `dynamicSchemaScriptCode`，解析 `objx` 后按生成模式插入行 |
+| `script` 模式 | 重新执行 `dynamicSchemaScript` 并刷新字段 |
+| 行为 | 删除上次动态生成的行 → 按 `dynamicSchemaMode` 插入 |
 | 默认 loading | 不显示全屏 loading |
-| 前提 | `dynamicSchemaEnabled: true` 且已配置 `dynamicSchemaScriptCode` |
+| 前提 | `dynamicSchemaSourceType` 为 `api` 或 `script`，且对应脚本已配置 |
 
 典型场景：主表 `billType` 变更、保存/加载单据后、点击「刷新表头」按钮。
 
@@ -915,9 +931,11 @@ attachments_<唯一后缀>
 
 ## 5. 完整综合 Java 示例代码
 
-脚本编码建议：`getDynamicSchemaFields`（配置在 table 容器「后台字段 → 脚本编码」）  
+脚本编码建议：`getDynamicSchemaFields`（配置在 table 容器「接口动态字段 → 脚本编码」）  
 返回类型：`List<Map<String, Object>>`，平台自动包装为响应 `objx` 数组。
 
+**前端字段脚本**（`dynamicSchemaSourceType: script`）不调接口，在设计器「前端字段脚本」中直接 `return` 与下方 JSON 相同结构的数组或 `{ fields: [...] }`。
+
 ### 5.1 脚本约定
 
 | 项目 | 说明 |
@@ -929,7 +947,7 @@ attachments_<唯一后缀>
 | 请求入参 | Java 脚本通过 `this.getBinding().getVariables()` 获取；表头脚本直接读 `formData`，见下方示例 |
 | 二次请求 | 下拉/状态等 `formScriptCode`、凭证 `getList` 需**单独维护**选项脚本 |
 
-读取表单数据示例（表头后台字段脚本）：
+读取表单数据示例（表头接口动态字段脚本）：
 
 ```java
 Map<String, Object> variables = this.getBinding().getVariables();
@@ -1215,7 +1233,7 @@ return fields;
 
 | 占位 | 说明 |
 |------|------|
-| `getDynamicSchemaFields` | table 容器「脚本编码」 |
+| `getDynamicSchemaFields` | table 容器「接口动态字段 → 脚本编码」 |
 | `payTypeList` | 下拉选项二次请求脚本 |
 | `ORDER_STATUS` | 系统词汇编码 |
 | `SUPPLIER_LIST` | 搜索弹框表单编码 |
@@ -1229,6 +1247,13 @@ return fields;
 
 | 容器配置 | 说明 |
 |---------|------|
+| `dynamicSchemaSourceType: none` | 不加载动态字段（默认） |
+| `dynamicSchemaSourceType: script` | 执行 `dynamicSchemaScript` 生成字段 |
+| `dynamicSchemaSourceType: api` | 请求 `dynamicSchemaScriptCode` 生成字段 |
+| `dynamicSchemaLoadScript` | 初始化前执行；`return false` 时不加载 |
+| `dynamicSchemaAnchorRowId` | anchor 模式占位行 id |
+| `dynamicSchemaAnchorPosition` | `replace` / `before` / `after`（设计器为下拉框） |
+| `dynamicSchemaInheritLayout` | anchor 模式是否继承占位行单元格布局 |
 | `dynamicSchemaColumns` | 每行列数，默认 4 |
 | `dynamicSchemaMode: append` | 追加到已有行之后 |
 | `dynamicSchemaMode: replace` | 清空已有行后替换 |
@@ -1254,7 +1279,7 @@ return fields;
 | 文件 | 说明 |
 |------|------|
 | `utils/dynamicSchemaUtil.js` | 协议常量（`DYNAMIC_SCHEMA_CORE_KEYS` 等）与规范化 |
-| `form-render/container-item/dynamicFieldMixin.js` | 表头后台字段运行时 |
+| `form-render/container-item/dynamicFieldMixin.js` | 表头动态字段运行时 |
 | `form-render/container-item/data-table-mixin.js` | 数据表格动态列运行时 |
 | `form-designer/.../table-dynamicField-editor.vue` | 表头设计器配置 |
 | `form-designer/.../data-table-editor.vue` | 数据表格设计器配置 |

package/src/components/xform/docs//346/225/260/346/215/256/350/241/250/346/240/274/345/212/250/346/200/201/345/210/227 JSON /350/257/264/346/230/216.md"

@@ -1,6 +1,6 @@
 # 数据表格动态列 JSON 说明
 
-> **本文只描述数据表格与表头后台字段的差异。** 控件类型、options 配置、选项脚本等**统一维护**在 [`后台字段（动态生成）JSON 说明.md`](./后台字段（动态生成）JSON%20说明.md)。
+> **本文只描述数据表格与表头动态字段的差异。** 控件类型、options 配置、选项脚本等**统一维护**在 [`后台字段（动态生成）JSON 说明.md`](./后台字段（动态生成）JSON%20说明.md)。
 >
 > **完整 JSON / Java 综合示例见 §0。** 协议代码：`utils/dynamicSchemaUtil.js` · 运行时：`form-render/container-item/data-table-mixin.js`
 
@@ -440,7 +440,7 @@ this.getWidgetRef("orderItemsTable").loadDynamicColumns({
 | 行为 | 按 `dynamicColumnMode` 合并静态列 → 重建列控件 → `reloadColumn` |
 | 前提 | `dynamicColumnSourceType` 为 `api` 或 `script`，且对应脚本已配置 |
 
-表头后台字段重新加载见主文档 **§1.5**（`loadDynamicSchema()`）。
+表头动态字段重新加载见主文档 **§1.5**（`loadDynamicSchema()`）。
 
 ---
 

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

@@ -20,6 +20,7 @@
       :disabled="field.options.disabled || isReadMode"
       :clearable="field.options.clearable"
       :filterable="field.options.filterable"
+      :collapse-tags="!field.options.flatCollapseTags"
       :placeholder="
         field.options.placeholder || i18nt('render.hint.selectPlaceholder')
       "