子表单

2022-02-22 09:46 更新

1. 什么是子表单

一种高级的容器组件,可以在其内部添加文本、数值、日期等组件,比如在商品录入时,需要添加多条商品信息等场景可使用。

2. 适用场景

子表单多用于录入数据的时候,比如出库单、入库单、销售单,其中的商品明细就可以用子表单记录,可以根据实际需要录入的数据新增条数。

3. 基础功能

升级项

升级前

升级后

【设置面板】

设置项混放,无分类,设置项查找困难

设置项按子表配置思路分类摆放,查找便利;

根据用户高频反馈,局部增加配置功能

子表单操作按钮排序【编辑态】

优先展示新增的操作项,无复制按钮

「复制」、「删除」按钮启用后,作为常驻按钮放在最前,之后再是用户自定义的操作按钮,最后为「上/下移」按钮(启用后展示);

编辑态下,默认展示全部按钮

注意:复制按钮暂未全量。

子表单操作按钮排序【提交态】

不支持复制操作,排序按钮会默认显示

初始状态(仅一条数据):不可操作删除

【平铺模式】增加子表单折叠/展开功能

会将多条明细全部展示出来,若超过20条会分页展示

(平铺方式下点击下图红色框符号均可出发展开/折叠操作)

列冻结(表格方式)

目前仅支持PC端冻结前几列

不支持冻结列

支持自定义冻结几列,最多冻结5列;

序号也记为1列;

默认设置无

自定义序号名称(平铺模式)

无序号名称设置项

序号名称可以自定义设置

3.1 排列方式

设置子表单的排列方式,默认以表格方式展示。

3.1.1 表格方式

表格

展示效果:

注:主题、显示表头,仅支持在 PC 端排列方式为表格方式时才展示

3.1.2 平铺方式

平铺

效果如图:

3.2 设置新增按钮名称

新增数据的按钮名称默认为新增一项,可以自定义名称,效果如图:

设置新增按钮名称

3.3 设置删除按钮名称

设置删除按钮名称

3.4 允许新增最大条数

可以自定义新增的数据条数,但体验版宜搭的上限目前是 50 条

注:所有宜搭付费版的应用(标准版、尊享版、钉钉专业版等),以前是200条,目前上限均提升至500条

子表单最大条数

3.5 子表列宽

支持自定义,再长内容也不怕显示不全

自定义子表单列宽

3.6 支持子表信息一键批量导入,告别一行行的手动输入

路径:访问表单即可看见在子表单下会有个批量导入的按钮,点击批量导入即可。(如表单开启了公开访问(免登),则表单内的子表单不支持批量导入操作)

子表单的批量导入模板字段顺序与表单设计字段顺序一致

访问页面

  • 子表数据高效录入:支持 Excel 批量导入数据
  • 子表单录入数据,新增子表单的「批量导入」入口批量导入每次支持50条

批量导入页面

导入成功之后,如图:

3.7 支持子表信息一键快速导出,轻量数据独立获取

  • 子表数据快速导出:
  • 表单详情页的子表单内容,支持子表信息快速导出 Excel

批量导出

批量导出中

批量导出成功

3.8 支持主表+子表单内容 Excel 一并导出

  • 支持主表单数据 + 子表单数据的一并导出

  • 导出新能力:
  • 子表信息导出,智能合并单元格子表信息导出本地 Excel 后,经过数据内容编辑,子表内容支持重新导回到宜搭表单数据中
  • 子表 + 基础组件目前支持导出后重新导入

表单页面

数据详情页面

Excel 表格页面

4. 高级功能

4.1 操作列

4.1.1 新建操作列

新建操作列之后,可以点击编辑去操作绑定动作

操作列

效果如图:

4.1.2 回调函数

参考 动作设置

操作--项目-0

回调函数

JS 面板

4.1.3 定制渲染

支持 jsx

定制渲染-绑定动作

效果如图:

5. 常见问题

5.1 如何批量删除子表单内的数据 ?

您好,需要配置一个删除动作,如下图所示:

注:这样操作默认是全删除,勾选批量删除目前还不支持

5.2 如何获取子表内指定的控件值 ?

获取子表单内的数据用于表单校验或作为数据源调用的入参等场景

参考代码:

const subFormInst = this.$('子表单唯一标识');
// 先获取 行 标识
const items = subFormInst.getItems(); //  ["tfitem_1", "tfitem_2"]
items.forEach(item => {
  const fieldInst = subFormInst.getComponent(item, '子表单内部控件的唯一标识');
  console.log(fieldInst.getValue());
});

5.3 子表关联子表 & 子表单赋值 ?

常用于跨应用关联子表数据以及表单加载时,初始化子表单数据的业务场景。

参考文档:明细关联明细

5.4 子表单数据导出 & 子表单数据进行报表分析 ?

由于子表单数据无法在数据管理页内展示分析且无法导出,所以需要将子表单数据于报表页面表格内进行展示和导出。

参考文档:子表单数据进行报表分析

5.5 在子表单里面设置了跳转函数,写出来的这个函数的按钮可以设置点击一次之后就隐藏吗 ?

可以在定制渲染里写上以下代码来实现。

export function onActionRender({ index, groupId, itemValue, actionKey }) {
 return <div id="anniu" onClick={()=>{
 document.getElementById('anniu').style.display = 'none'
 }}>操作按钮名称</div>;
}

5.6 子表单上移下移按钮怎么设置 ?

这个是一个隐藏功能,去表单的编辑页面开启子表单的显示排序就会出现上移下移按钮,如图所示:

5.7 是否可以校验子表单中 多行文本组件中 其中一行文本的唯一性 ?

配置子表单内组件的自定义校验函数,遍历子表单中的所有数据,跟当前的数据来进行比对

5.8 如何自动获取子表单内一共有多少条数据?

(1)使用一个子表单组件,一个数值组件,然后将数值组件的默认值设置为 1,如图:

(2)点击子表单>>高级>>新建动作,需要创建两个动作,一个是 onAddClick 点击添加;一个是 onDelClick 点击删除,创建动作写入代码,如图:

以下代码可直接复制使用,注意:第一个括号里面输入数值组件的唯一标识,第二个括号里面输入子表单的唯一标识。可参考(3)的设置

this.$('数值组件标识').setValue(this.$('子表单标识').getValue().length);

(3)先创建一个 onAddClick 点击添加,如图:

然后将上面的代码复制过来,如下:

(4)新建一个 onDelClick 点击删除,也直接复制上面的代码即可:

然后将上一段的代码复制下来:

点击保存后,效果展示如下:

删除新增一项的数据,也会自动减少:

5.9 如何变量控制子表单的条数?

(1)拉取一个数值组件,在数值组件绑定动作「onChange值发生变化」

(2)在js页面复制以下代码

export function onChange({ value }) {
  console.log('onChange', value);
  let a = [];
  for(let i=0;i<value;i++){
      let b= {
        "textField_kurr4i2o" : "",   //子表单内其他组件唯一标识
      }
      a.push(b)
  }
  this.$("tableField_kurr4i2m").setValue(a)   //子表单组件唯一标识
}

(3)实现效果


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号