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 +1 -1
- package/src/components/xform/docs//347/272/247/350/201/224/351/200/211/346/213/251/346/207/222/345/212/240/350/275/275/344/275/277/347/224/250/350/257/264/346/230/216.md +147 -85
- package/src/views/user/wf/wf_manage/list.vue +7 -1
- package/src/views/user/wf/wf_manage/list2.vue +7 -1
- package/src/views/user/wf/wf_manage/wfContentDialog.vue +7 -1
package/package.json
CHANGED
|
@@ -1,68 +1,114 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 级联选择懒加载使用说明
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
级联选择开启懒加载后,展开每一级才请求下一级数据,走字段上的「请求访问」,脚本只支持 **list**(`objx` 为数组),不走分页,也不走 `condition`。
|
|
4
4
|
|
|
5
5
|
未开启懒加载时,仍使用选项里配好的整棵树。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
---
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
## 一、业务示例:地区全称 + 省市区镇分字段
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
常见做法是:**地区全称**只做选择入口,不入库;**省、市、区、镇**的名称和 ID 单独存文本字段。详情页接口只返回分字段,全称每次打开保持空白,不回显。
|
|
12
12
|
|
|
13
|
-
|
|
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
|
-
|
|
16
|
-
- 不打开时,`taBm` 就是组件名。
|
|
25
|
+
列表接口每一行建议返回(供选中回写):
|
|
17
26
|
|
|
18
|
-
|
|
27
|
+
- `tree_path`:各级 ID,英文逗号分隔,如 `44,4401,440106,440106001`
|
|
28
|
+
- `tree_path_name`:各级名称,英文逗号分隔,如 `广东省,广州市,天河区,石牌街道`
|
|
19
29
|
|
|
20
|
-
|
|
30
|
+
---
|
|
21
31
|
|
|
22
|
-
|
|
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
|
-
###
|
|
36
|
+
### 步骤 1:字段键名(taBm)
|
|
32
37
|
|
|
33
|
-
|
|
38
|
+
请求体里的 `taBm` 用的是**这个级联字段本身**:
|
|
34
39
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
3. 「请求去掉 data 层」默认不勾。勾上之后,父级参数会平铺到外层,不再包在 `data` 里。
|
|
38
|
-
4. 返回结果需要过滤时,再写「查询回调」。返回数组就用这份数组作为本级节点。
|
|
40
|
+
- 打开「数据属性名称」并填写 `keyName` 时,`taBm` = 该 `keyName`。
|
|
41
|
+
- 不打开时,`taBm` = 组件唯一名称(如 `a1`)。
|
|
39
42
|
|
|
40
|
-
|
|
43
|
+
**地区全称 a1 不要开「数据属性名称」**,避免把级联值写入表单数据。
|
|
41
44
|
|
|
42
|
-
###
|
|
45
|
+
### 步骤 2:打开懒加载
|
|
43
46
|
|
|
44
|
-
|
|
47
|
+
在常用设置里打开「**懒加载**」。打开后出现:
|
|
45
48
|
|
|
46
|
-
|
|
47
|
-
|
|
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
|
-
###
|
|
55
|
+
### 步骤 3:请求访问
|
|
50
56
|
|
|
51
|
-
|
|
57
|
+
在「请求访问设置」中:
|
|
52
58
|
|
|
53
|
-
|
|
59
|
+
1. 打开「**启用请求后台脚本**」。不打开则不会按本文 list 方式请求(可走 `onLazyLoad` 自定义,见文末)。
|
|
60
|
+
2. 填写「**表单脚本编码**」,留空默认 `getList`。
|
|
61
|
+
3. 「请求去掉 data 层」按需勾选;默认不勾,父级参数在 `data` 内。
|
|
62
|
+
4. 需要过滤本级节点时,再写「**查询回调**」`formScriptSuccess`,返回数组替换本级列表。
|
|
54
63
|
|
|
55
|
-
|
|
64
|
+
**不要改「查询参数」**;懒加载不会读取 `formScriptParam`。
|
|
56
65
|
|
|
57
|
-
|
|
66
|
+
### 步骤 4:显示字段 / 关联字段
|
|
58
67
|
|
|
59
|
-
|
|
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
|
|
63
|
-
let data = item
|
|
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
|
-
|
|
122
|
+
### 3.2 onClear:清空分字段
|
|
77
123
|
|
|
78
|
-
|
|
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
|
-
|
|
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: "
|
|
179
|
+
taBm: "a1",
|
|
101
180
|
data: {
|
|
102
181
|
f_parent: 64
|
|
103
182
|
}
|
|
104
183
|
}
|
|
105
184
|
```
|
|
106
185
|
|
|
107
|
-
`fixeData
|
|
108
|
-
|
|
109
|
-
|
|
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
|
-
|
|
191
|
+
带传参脚本示例:
|
|
124
192
|
|
|
125
193
|
```js
|
|
126
194
|
{
|
|
127
195
|
fixeData: {},
|
|
128
196
|
formCode: "kehu3_detail",
|
|
129
197
|
formVersion: 39,
|
|
130
|
-
taBm: "
|
|
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
|
-
|
|
140
|
-
|
|
141
|
-
## 返回
|
|
207
|
+
### 4.2 返回
|
|
142
208
|
|
|
143
|
-
`objx`
|
|
209
|
+
`objx` **必须是数组**(不是 `objx.records`)。每行至少包含显示字段、关联字段,以及有子节点标识(或 `leaf`):
|
|
144
210
|
|
|
145
211
|
```js
|
|
146
212
|
[
|
|
147
|
-
{
|
|
148
|
-
{
|
|
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
|
-
|
|
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
|
-
|
|
230
|
+
---
|
|
170
231
|
|
|
171
|
-
|
|
232
|
+
## 六、配置检查清单
|
|
172
233
|
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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;
|