cloud-web-corejs 1.1.0-dev.77 → 1.1.0-dev.78

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "cloud-web-corejs",
3
3
  "private": false,
4
- "version": "1.1.0-dev.77",
4
+ "version": "1.1.0-dev.78",
5
5
  "scripts": {
6
6
  "build:ace-resources": "node build/build-ace-resources.js",
7
7
  "build:tinymce-resources": "node build/build-tinymce-resources.js",
@@ -1,68 +1,114 @@
1
- # 级联选择懒加载
1
+ # 级联选择懒加载使用说明
2
2
 
3
- 级联选择开启懒加载后,展开每一级才请求下一级数据,走字段上的「请求访问」,脚本用 list,不走分页,也不走 condition。
3
+ 级联选择开启懒加载后,展开每一级才请求下一级数据,走字段上的「请求访问」,脚本只支持 **list**(`objx` 为数组),不走分页,也不走 `condition`。
4
4
 
5
5
  未开启懒加载时,仍使用选项里配好的整棵树。
6
6
 
7
- ## 配置过程
7
+ ---
8
8
 
9
- 在表单设计器里拖入「级联选择」,点中该组件,在右侧属性面板按下面的顺序配置。
9
+ ## 一、业务示例:地区全称 + 省市区镇分字段
10
10
 
11
- ### 1. 确定字段键名
11
+ 常见做法是:**地区全称**只做选择入口,不入库;**省、市、区、镇**的名称和 ID 单独存文本字段。详情页接口只返回分字段,全称每次打开保持空白,不回显。
12
12
 
13
- 请求里的 `taBm` 用的是这个字段本身。
13
+ | 含义 | 组件类型 | 唯一名称 | 是否入库 |
14
+ |----------|------------|----------|----------|
15
+ | 地区全称 | 级联选择 | a1 | 否(不要开「数据属性名称」) |
16
+ | 省 | 文本 | a2 | 是 |
17
+ | 省 ID | 文本 | a3 | 是 |
18
+ | 市 | 文本 | a4 | 是 |
19
+ | 市 ID | 文本 | a5 | 是 |
20
+ | 区 | 文本 | a6 | 是 |
21
+ | 区 ID | 文本 | a7 | 是 |
22
+ | 镇 | 文本 | a8 | 是 |
23
+ | 镇 ID | 文本 | a9 | 是 |
14
24
 
15
- - 要用数据属性名称时,打开「数据属性名称」,填写 `keyName`,例如 `cf_kehu2_item`。
16
- - 不打开时,`taBm` 就是组件名。
25
+ 列表接口每一行建议返回(供选中回写):
17
26
 
18
- ### 2. 打开懒加载
27
+ - `tree_path`:各级 ID,英文逗号分隔,如 `44,4401,440106,440106001`
28
+ - `tree_path_name`:各级名称,英文逗号分隔,如 `广东省,广州市,天河区,石牌街道`
19
29
 
20
- 在常用设置里打开「懒加载」。打开后下面出现三项:
30
+ ---
21
31
 
22
- 1. **父级字段**
23
- 传到后台的参数名,和数据集里的父级字段一致。可以留空,留空时请求使用 `f_parent`。输入框里不会自动填上 `f_parent`。父级值取的是当前节点的「关联字段」,可以是 ID,也可以是编码。
24
- 2. **有子节点标识**
25
- 返回行里表示是否还有下级的字段。可以留空,留空时按 `f_has_child` 判断。`true`、`1` 可以继续展开,`false`、`0` 是末级。
26
- 3. **传参脚本**
27
- 需要把选中行上的其他字段一并传给后台时再写。点编辑图标,脚本签名是 `lazyParamScript(dataId, formCode, row)`。`row` 是当前选中行,第一次展开根节点时是 `null`。返回对象会并入 `data`。不写就只传父级字段。
32
+ ## 二、表单设计器配置步骤
28
33
 
29
- 这项不使用「请求访问设置」里的查询参数。查询参数保持原样,懒加载不会读它。
34
+ 在表单设计器拖入「级联选择」作为 `a1`,再拖入 8 个文本字段 `a2`~`a9`。选中 `a1`,在右侧属性面板按顺序配置。
30
35
 
31
- ### 3. 打开请求访问
36
+ ### 步骤 1:字段键名(taBm)
32
37
 
33
- 往下找到「请求访问设置」:
38
+ 请求体里的 `taBm` 用的是**这个级联字段本身**:
34
39
 
35
- 1. 打开「启用请求后台脚本」。不打开的话,懒加载不会按本文的 list 请求发数据。
36
- 2. 填写「表单脚本编码」。留空时使用 `getList`。脚本要返回数组,不要走分页,也不要走 condition。
37
- 3. 「请求去掉 data 层」默认不勾。勾上之后,父级参数会平铺到外层,不再包在 `data` 里。
38
- 4. 返回结果需要过滤时,再写「查询回调」。返回数组就用这份数组作为本级节点。
40
+ - 打开「数据属性名称」并填写 `keyName` 时,`taBm` = 该 `keyName`。
41
+ - 不打开时,`taBm` = 组件唯一名称(如 `a1`)。
39
42
 
40
- 查询参数不用改。
43
+ **地区全称 a1 不要开「数据属性名称」**,避免把级联值写入表单数据。
41
44
 
42
- ### 4. 对齐返回列
45
+ ### 步骤 2:打开懒加载
43
46
 
44
- 启用请求后台脚本之后,选项设置里的「显示字段」「关联字段」才能改。
47
+ 在常用设置里打开「**懒加载**」。打开后出现:
45
48
 
46
- 1. **显示字段**:节点上显示的文字,默认 `label`。改成数据集里的名称列,例如 `f_name`。
47
- 2. **关联字段**:选中后保存的值,也是下一级 `f_parent` 带上的值,默认 `value`。改成数据集里的主键或编码列,例如 `id` 或 `f_code`。
49
+ | 配置项 | 说明 |
50
+ |--------------|------|
51
+ | **父级字段** | 传到后台的参数名,与数据集父级字段一致。可留空,留空时请求使用 `f_parent`(不会自动写回输入框)。值取当前节点「关联字段」,可以是 ID 或编码。 |
52
+ | **有子节点标识** | 返回行里表示是否还有下级。可留空,留空时按 `f_has_child` 判断。`true`/`1` 可展开,`false`/`0` 为末级。 |
53
+ | **传参脚本** | 可选。签名 `lazyParamScript(dataId, formCode, row)`。`row` 为当前选中行,根节点为 `null`。返回对象并入 `data`。**不使用**「请求访问」里的查询参数。 |
48
54
 
49
- ### 5. 保存并展开验证
55
+ ### 步骤 3:请求访问
50
56
 
51
- 保存表单后预览。第一次点开级联,请求体里父级值是 `null`。再点开某一行,父级值变成该行的关联字段值。有子节点标识为末级的行不再出现展开箭头。
57
+ 在「请求访问设置」中:
52
58
 
53
- ## 选中回写
59
+ 1. 打开「**启用请求后台脚本**」。不打开则不会按本文 list 方式请求(可走 `onLazyLoad` 自定义,见文末)。
60
+ 2. 填写「**表单脚本编码**」,留空默认 `getList`。
61
+ 3. 「请求去掉 data 层」按需勾选;默认不勾,父级参数在 `data` 内。
62
+ 4. 需要过滤本级节点时,再写「**查询回调**」`formScriptSuccess`,返回数组替换本级列表。
54
63
 
55
- 地区全称不入库,每次打开保持空白,不用在 `onMounted` 里回显。省、市、区、镇的名称和 ID 在选中时写入,清空时单独处理。
64
+ **不要改「查询参数」**;懒加载不会读取 `formScriptParam`。
56
65
 
57
- 级联有 `onSelect`,只在用户选中时触发,清空不进这个事件。参数是 `value`、`oldValue`、`item`。`item.level` 是当前选到的级别:`0` 省、`1` 市、`2` 区、`3` 镇。各级 ID 在选中行的 `tree_path` 里,各级名称在 `tree_path_name` 里,都以英文逗号分隔。例如 `tree_path` 为 `44,4401,440106,440106001`,`tree_path_name` 为 `广东省,广州市,天河区,石牌街道`。
66
+ ### 步骤 4:显示字段 / 关联字段
58
67
 
59
- 在地区全称 `a1` 的 `onSelect` 里按级别回写,没选到的级别写成空:
68
+ 启用请求后台脚本后,在选项设置里可改:
69
+
70
+ - **显示字段**:下拉展示列,默认 `label`,可改为 `f_name` 等。
71
+ - **关联字段**:选中值及下一级 `f_parent` 取值列,默认 `value`,可改为 `id`、`f_code` 等。
72
+
73
+ ### 步骤 5:事件脚本(a1)
74
+
75
+ 在「事件设置」中为 `a1` 配置:
76
+
77
+ | 事件 | 何时触发 |
78
+ |------------|----------|
79
+ | **onChange** | 值变化时(含选中、清空),**先于** onSelect / onClear 执行。 |
80
+ | **onSelect** | 仅用户**选中**某一级时。 |
81
+ | **onClear** | 仅用户点**清空**时,**不走** onSelect。 |
82
+
83
+ 赋值给其他字段请用:`this.getWidgetRef("字段唯一名称").setValue(值)`。
84
+
85
+ ### 步骤 6:保存并验证
86
+
87
+ 保存表单后预览:
88
+
89
+ - 第一次展开级联,请求里 `f_parent` 为 `null`。
90
+ - 展开某一行后,`f_parent` 为该行的关联字段值。
91
+ - 选中后 `a2`~`a9` 按脚本写入;清空后 `onClear` 清空这 8 个字段。
92
+
93
+ ---
94
+
95
+ ## 三、脚本示例(a1)
96
+
97
+ ### 3.1 onSelect:按级别回写省市区镇
98
+
99
+ `onSelect(dataId, formCode, value, oldValue, item, rowData, rowIndex)`
100
+
101
+ - `item.level`:**固定**,当前选到的级别 `0` 省、`1` 市、`2` 区、`3` 镇。
102
+ - `item.data`:**固定**,当前选中行的原始数据;`tree_path`、`tree_path_name` 需列表接口返回。
103
+
104
+ 只选到某一级时,更高级别写入,更低级别清空。
60
105
 
61
106
  ```js
62
- let level = item ? item.level : -1;
63
- let data = item && item.data ? item.data : {};
107
+ let level = item.level;
108
+ let data = item.data || {};
64
109
  let ids = data.tree_path ? String(data.tree_path).split(",") : [];
65
110
  let names = data.tree_path_name ? String(data.tree_path_name).split(",") : [];
111
+
66
112
  this.getWidgetRef("a2").setValue(level >= 0 ? names[0] || null : null);
67
113
  this.getWidgetRef("a3").setValue(level >= 0 ? ids[0] || null : null);
68
114
  this.getWidgetRef("a4").setValue(level >= 1 ? names[1] || null : null);
@@ -73,9 +119,9 @@ this.getWidgetRef("a8").setValue(level >= 3 ? names[3] || null : null);
73
119
  this.getWidgetRef("a9").setValue(level >= 3 ? ids[3] || null : null);
74
120
  ```
75
121
 
76
- 某一级没有选到时,对应字段写成空。`a1` 不要开「数据属性名称」。
122
+ ### 3.2 onClear:清空分字段
77
123
 
78
- 清空走 `onClear`,不进 `onSelect`。在 `a1` 的 `onClear` 里把省市区镇清空:
124
+ `onClear(dataId, formCode, rowData, rowIndex)`
79
125
 
80
126
  ```js
81
127
  this.getWidgetRef("a2").setValue(null);
@@ -88,46 +134,68 @@ this.getWidgetRef("a8").setValue(null);
88
134
  this.getWidgetRef("a9").setValue(null);
89
135
  ```
90
136
 
91
- ## 请求
137
+ ### 3.3 传参脚本 lazyParamScript(可选)
138
+
139
+ 展开非根节点时,把选中行其他字段带入 `data`:
140
+
141
+ ```js
142
+ // lazyParamScript(dataId, formCode, row)
143
+ if (!row) return {};
144
+ return {
145
+ f_code: row.f_code
146
+ };
147
+ ```
148
+
149
+ ### 3.4 查询回调 formScriptSuccess(可选)
150
+
151
+ ```js
152
+ // formScriptSuccess(dataId, formCode, res, rows)
153
+ return rows.filter(function (item) {
154
+ return item.enabled !== false;
155
+ });
156
+ ```
157
+
158
+ ### 3.5 上级条件变化后重载懒加载树
159
+
160
+ ```js
161
+ this.getFormRef().getWidgetRef("a1").reloadLazyNodes();
162
+ ```
163
+
164
+ ---
165
+
166
+ ## 四、后台请求与返回
167
+
168
+ ### 4.1 请求
92
169
 
93
- 脚本编码走地址 `/{服务名}/bd_api/{formCode}/{scriptCode}`,不放进 body。展开节点时的请求体是:
170
+ 脚本编码在 URL:`/{服务名}/bd_api/{formCode}/{scriptCode}`,**不在 body**。
171
+
172
+ 展开节点时 body 示例:
94
173
 
95
174
  ```js
96
175
  {
97
176
  fixeData: {},
98
177
  formCode: "kehu3_detail",
99
178
  formVersion: 39,
100
- taBm: "cf_kehu2_item",
179
+ taBm: "a1",
101
180
  data: {
102
181
  f_parent: 64
103
182
  }
104
183
  }
105
184
  ```
106
185
 
107
- `fixeData` 由 `formHttp` 补上,来自当前报表的全局参数,没有时是 `{}`。`taBm` 是字段本身。`data` 里是父级参数和传参脚本返回的字段,没有 `current`、`size`、`condition`。请求访问里的查询参数不参与这次请求。
108
-
109
- `f_parent` 的值取当前节点的「关联字段」。这一列可以是 ID,也可以是编码。根节点是 `null`。上面例子里关联字段的值是 `64`,所以 `f_parent` 就是 `64`。
110
-
111
- 传参脚本可以带上选中行的其他字段。父级字段仍以「父级字段」的配置为准。
112
-
113
- ```js
114
- // lazyParamScript(dataId, formCode, row)
115
- // row 为当前选中行,根节点为 null
116
- if (!row) return {};
117
- return {
118
- f_code: row.f_code,
119
- f_name: row.f_name
120
- };
121
- ```
186
+ - `fixeData`:由 `formHttp` 补全,来自报表全局参数,无则为 `{}`。
187
+ - `data` 中无 `current`、`size`、`condition`。
188
+ - 根节点:`f_parent` 为 `null`。
189
+ - 传参脚本与父级字段同时存在时,**父级字段名以配置为准**,传参脚本字段并入 `data`(同名时父级字段覆盖传参脚本)。
122
190
 
123
- 展开编码 `A01`、同时带上该行 `f_code` 时,请求体是:
191
+ 带传参脚本示例:
124
192
 
125
193
  ```js
126
194
  {
127
195
  fixeData: {},
128
196
  formCode: "kehu3_detail",
129
197
  formVersion: 39,
130
- taBm: "cf_kehu2_item",
198
+ taBm: "a1",
131
199
  data: {
132
200
  f_parent: 64,
133
201
  f_code: "A01",
@@ -136,42 +204,36 @@ return {
136
204
  }
137
205
  ```
138
206
 
139
- `node.level === 0` 是根节点。下一级时 `node.value` 就是当前节点的关联字段值,`row` 是这一行的原始数据。
140
-
141
- ## 返回
207
+ ### 4.2 返回
142
208
 
143
- `objx` 必须是数组。每一行至少包含显示字段、关联字段,以及有子节点标识:
209
+ `objx` **必须是数组**(不是 `objx.records`)。每行至少包含显示字段、关联字段,以及有子节点标识(或 `leaf`):
144
210
 
145
211
  ```js
146
212
  [
147
- { label: "华东", value: "EAST", f_has_child: true },
148
- { label: "上海", value: "SH", f_has_child: false }
213
+ { f_name: "华东", id: 64, f_has_child: true, tree_path: "64", tree_path_name: "华东" },
214
+ { f_name: "上海", id: 65, f_has_child: false, tree_path: "64,65", tree_path_name: "华东,上海" }
149
215
  ]
150
216
  ```
151
217
 
152
- `f_has_child` 为 true、1 时可以继续展开,为 false、0 时视为末级。字段名在「有子节点标识」里改。这一列没有值、但行上带了 `leaf` 时,仍按 `leaf` 判断。未标记的节点会一直显示展开箭头。
153
-
154
- 查询回调可以改本级数据,返回数组即可:
155
-
156
- ```js
157
- // formScriptSuccess(dataId, formCode, res, rows)
158
- return rows.filter(item => item.enabled !== false);
159
- ```
160
-
161
- ## 保存与回显
162
-
163
- 选中值按各级关联字段组成数组保存,例如 `["EAST", "SH"]`。多选时是多条路径。
218
+ ---
164
219
 
165
- 只读展示依赖已经加载过的节点名称。还没展开过的路径,只能显示原始值。
220
+ ## 五、说明与限制
166
221
 
167
- ## 自定义请求
222
+ | 项 | 说明 |
223
+ |----|------|
224
+ | 事件顺序 | 同一次操作:**onChange → onSelect**(选中)或 **onChange → onClear**(清空)。 |
225
+ | 详情回显 | 全称 a1 不入库时,**不必**在 `onMounted` 里回显 a1;分字段由详情接口赋值即可。 |
226
+ | 只读展示 | 懒加载只读展示依赖已加载节点;未展开过的路径可能只显示原始值。 |
227
+ | 自定义懒加载 | 未启用「请求后台脚本」时使用 `onLazyLoad(node, resolve)`,须调用 `resolve(节点数组)`;启用后**不执行** onLazyLoad。 |
228
+ | initLazyChecked | 若需仅用脚本展示全称且不写 formModel,可调用组件方法 `initLazyChecked([{ value, label }, ...])`;与「每次打开全称空白」场景二选一。 |
168
229
 
169
- 未启用「请求后台脚本」时,才走事件 `onLazyLoad(node, resolve)`。脚本里必须调用 `resolve(节点数组)`。末级节点同样按有子节点标识返回,默认字段名是 `f_has_child`。
230
+ ---
170
231
 
171
- 启用了请求访问之后,不会再执行 `onLazyLoad`。
232
+ ## 六、配置检查清单
172
233
 
173
- 上级条件变化后需要重载时,取到级联组件再调用:
174
-
175
- ```js
176
- this.getFormRef().getWidgetRef("级联字段名").reloadLazyNodes();
177
- ```
234
+ - [ ] a1 已开懒加载 + 请求访问 + 脚本编码(默认 getList)
235
+ - [ ] 显示字段 / 关联字段与数据集列一致
236
+ - [ ] 列表行含 `tree_path`、`tree_path_name`(英文逗号分隔)
237
+ - [ ] a1 未开「数据属性名称」
238
+ - [ ] a1 已配 onSelect、onClear;分字段用 `getWidgetRef("xx").setValue`
239
+ - [ ] 未依赖查询参数做懒加载;传参用传参脚本
@@ -654,7 +654,13 @@ export default {
654
654
  // ($openEditView 是 200ms 定时放行,冷启动拉 chunk 常超过它)
655
655
  async openEditDialog(row) {
656
656
  let id = row.objId;
657
- let wfDataId = !id || typeof id == "object" ? 0 : Number(id);
657
+ // 数字(含数字字符串)保持原有 Number 转换;非数字字符串原样传给表单
658
+ let wfDataId = id;
659
+ if (!id || typeof id == "object") {
660
+ wfDataId = 0;
661
+ } else if (!isNaN(id)) {
662
+ wfDataId = Number(id);
663
+ }
658
664
 
659
665
  if (row.url == "form") {
660
666
  let formCode = null;
@@ -528,7 +528,13 @@ export default {
528
528
  // ($openEditView 是 200ms 定时放行,冷启动拉 chunk 常超过它)
529
529
  async openEditDialog(row) {
530
530
  let id = row.objId;
531
- let wfDataId = !id || typeof id == "object" ? 0 : Number(id);
531
+ // 数字(含数字字符串)保持原有 Number 转换;非数字字符串原样传给表单
532
+ let wfDataId = id;
533
+ if (!id || typeof id == "object") {
534
+ wfDataId = 0;
535
+ } else if (!isNaN(id)) {
536
+ wfDataId = Number(id);
537
+ }
532
538
 
533
539
  if (row.url == "form") {
534
540
  let formCode = null;
@@ -104,7 +104,13 @@ export default {
104
104
  });
105
105
  try {
106
106
  let id = this.option.objId;
107
- let wfDataId = !id || typeof id == "object" ? 0 : Number(id);
107
+ // 数字(含数字字符串)保持原有 Number 转换;非数字字符串原样传给表单
108
+ let wfDataId = id;
109
+ if (!id || typeof id == "object") {
110
+ wfDataId = 0;
111
+ } else if (!isNaN(id)) {
112
+ wfDataId = Number(id);
113
+ }
108
114
  let param = this.option.param || {};
109
115
  if (this.option.url == "form") {
110
116
  let formCode = null;