子列表

# 子列表

# 开发准备

* 脚本必须使用ES5以下的语法规则编写

* 所有内容适用于子列表

# 获取子表对象

```
// 表单、表单自定义组件上面使用  
const subtable = dataForm.getSubTable('5eff9648a0');  
// '5eff9648a0'是子表code

```

# 监听

### 添加子表加载完成的回调

```
subTable.addLoadedCallback(callback);  
```

#### 输入参数

| 参数 | 类型 | 必填 | 含义 |
| --- | --- | --- | --- |
| callback | function | 是 | 子表加载完成后的回调函数 |

#### 返回内容：无

#### 样例：

```
subTable.addLoadedCallback(() => {  
 // 处理逻辑  
});

```

### 添加按钮前置

```
subTable.addButtonBefore(title, callback)

```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| title | string | 是 | 按钮名称 |
| callback | function | 是 | 按钮功能实现前的回调 |

#### 返回内容：无

#### 样例：

```
subTable.addButtonBefore(title, (datas, resolve) => {
  // `datas` 是勾选的子表数据
  // `resolve` 是按钮后续的动作，如果想继续执行按钮的动作就调用 `resolve()`
})
```

### 添加按钮后置

```
subTable.addButtonAfter(title, callback)  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| titles | string | 是 | 按钮名称 |
| callback | function | 是 | 按钮功能实现后的回调 |

#### 返回内容：无

#### 样例：

```
subTable.addButtonAfter(title, (datas, resolve) => {
  // `datas` 是勾选的子表数据
  // `resolve` 是按钮后续的动作，如果想继续执行按钮的动作就调用 `resolve()`
})
```

# 规则

### 隐藏操作按钮

```
subTable.isHiddenButton(titles, hide)  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| titles | array | 是 | 按钮名称 |
| hide | bool | 否 | 是否隐藏，默认false |

#### 返回内容：无

#### 返回数据样例：无

# 数据处理

### 数据增加

```
subTable.$dataHandler.addSubData(parentCode, parentObjectId, objectId, subCode, data);  
```

#### 支持版本：V8\.6

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| ~~datas~~ | ~~array~~ | ~~是~~ | ~~列表数据~~ |
| parentCode | string | 是 | 主表Code |
| parentObjectId | string | 是 | 主表ObjectId |
| objectId | string | 否 | 数据ID，guid格式。指定创建数据的数据ID，传空会默认生成一个ID |
| subCode | string | 是 | 子表Code |
| data | object | 是 | 数据内容，key\-value形式。key是字段名，value是字段值 |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
subTable.$dataHandler.addSubData(
		'2588109ed74aeaa6',
		'337b135e-996d-4331-a416-aa7ed7dd1a72',
		'',
		'0021223ab1',
		{
			wenb: 'x123',
      shuz: 12,
      riq: "2024-10-08",
      xial: "xxx",
      xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
      fux: 'xxx,xxx',
      reny: '系统管理员',
      bum: '项目部',
      shic: 'xx分xx秒',
      jilxl: 'xxx/xxx',
      fuwb: '<h1>xxx</h1>',
      duox: 'test1,test2',
  		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      guanl: "xxx",
      guanl_Id: "1ad88d9d-52cb-4622-a292-c370fabac565",
		}
	).then(()=> {
		// 成功的回调
	}).catch(() => {
		// 失败的回调
	});
```

### 数据删除

```
subTable.$dataHandler.deleteData(ids);  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| ids | array | 是 | 要删除的列表数据id |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
const ids = [
  'xxx',
  'yyy'
];
subTable.$dataHandler.deleteData(ids).then(res => {
  // 成功的回调
}).catch(error => {
  // 错误的回调
});
```

### 数据修改

```

subTable.$dataHandler.updateListSubData(dataMaps)  
```

#### 输入参数：

| 参数 | | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| dataMap |  | array | 是 | 修改的所有数据 |
|  | ~~id~~ | ~~string~~ | ~~是~~ | ~~数据的Id~~ |
|  | ~~data~~ | ~~object~~ | ~~是~~ | ~~修改的数据~~ |
|  | parentCode | string | 是 | 主表code |
|  | parentObjectId | string | 是 | 主表objectID |
|  | objectId | string | 是 | 子表objectID |
|  | subCode | string | 是 | 子表Code |
|  | data | object | 是 | 数据内容，key\-value形式。key是字段名，value是字段值 |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
subTable.$dataHandler.updateListData(
  [
    {
      formCode: "1a04ff66d02bbc01",
      objectId: "ecebf331-89ed-4135-b6cd-39715e15d222",
      data: {
        danxwb: "xxx",
        shuz: 12,
				riq: "2024-10-09",
				xial: "xxx",
        xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
        fux: 'xxx,xxx',
        reny: '系统管理员',
        bum: '项目部',
        shic: 'xx分xx秒',
        jilxl: 'xxx/xxx',
        fuwb: '<h1>xxx</h1>',
        duox: 'test1,test2',
      	duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
				guanl: "xxx",
				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
      },
      subData: [
        {
          subCode: "1be0ad7b1e",
          datas: [
          	{
            	aaa: "aaa",
            	shuz: 22,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	},
            {
            	bbb: "bbb",
            	shuz: 32,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	}
          ]
        },
        {
          subCode: "7d4g39fhr5",
          datas: [
          	{
            	ccc: "ccc",
            	xuhao: 1,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	},
            {
            	ddd: "ddd",
            	xuhao: 2,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	}
          ]
        }
      ]
    },
    {
      formCode: "1a04ff66d02bbc01",
      objectId: "ecebf221-89ed-4135-b6cd-39715e15d222",
      data: {
        danxwb: "xxx",
        shuz: 12,
        riq: "2024-10-09",
      	xial: "xxx",
        xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
        fux: 'xxx,xxx',
        reny: '系统管理员',
        bum: '项目部',
        shic: 'xx分xx秒',
        jilxl: 'xxx/xxx',
        fuwb: '<h1>xxx</h1>',
        duox: 'test1,test2',
    		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      	guanl: "xxx",
      	guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
      },
      subData: [
        {
          subCode: "1be0ad7b1e",
          datas: [
          	{
            	aaa: "aaa",
            	shuz: 22,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	},
            {
            	bbb: "bbb",
            	shuz: 32,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	}
          ]
        },
        {
          subCode: "7d4g39fhr5",
          datas: [
          	{
            	ccc: "ccc",
            	xuhao: 1,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	},
            {
            	ddd: "ddd",
            	xuhao: 2,
              riq: "2024-10-09",
      				xial: "xxx",
              xial_Id: 'xxx', // key为下拉控件字段名加_Id,值为下拉数据的ObjectID
              fux: 'xxx,xxx',
              reny: '系统管理员',
              bum: '项目部',
              shic: 'xx分xx秒',
              jilxl: 'xxx/xxx',
              fuwb: '<h1>xxx</h1>',
              duox: 'test1,test2',
          		duox_Id: 'bb5a5281-d7af-4303-b81c-633cb46cc215,1ad88d9d-52cb-4622-a292-c370fabac565',  //key为多选字段名加_Id,值为多选数据的ObjectID
      				guanl: "xxx",
      				guanl_Id: "bb5a5281-d7af-4303-b81c-633cb46cc215",
          	}
          ]
        }
      ]
    }
  ]
).then(function(res) {
  // 更新成功
}).catch(function(error) {
  // 更新失败
});
```

### ~~数据查询~~

暂未实现

```

subTable.queryData(ids)；

```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| ids | string | 是 | 查询数据id |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
const ids = [
  'xxx',
  'yyy'
];
subTable.queryData(ids).then(res => {
  // 成功的回调
  // `res.Result` 是查询到的数据
}).catch(error => {
  // 错误的回调
});
```

# 其他

### 列表数据拷贝并赋值

```
subTable.columnDataCopy(code, targetCode)  
```

#### 输入参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| code | string | 是 | 拷贝的列code |
| targetCode | string | 是 | 赋值的列code |

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：

```
subTable.columnDataCopy('f_xxx', 'f_yyy').then(res => {
  // 成功的回调
}).catch(error => {
  // 错误的回调
});
```

### 刷新列表

只刷新子列表不刷新页面

```
subTable.reload()

```

#### 输入参数：无

#### 返回内容：

返回一个Promise类型的对象，可以直接通过then来处理正确回调，通过catch来处理错误回调

#### 样例：无

```

subTable.reload().then(res => {
  // 成功的回调
}).catch(error => {
  // 失败的回调
})
```

### 获取选择的数据

```
subTable.selectedItems

```

#### 输入参数：无

#### 返回内容：

| 参数 | 类型 | 含义 |
| --- | --- | --- |
| datas | array | 选中的列表数据 |

#### 样例：

```

const datas = subTable.selectedItems;  
```