跳到主要内容

数据容器

1. 什么是数据容器?

数据容器(Data Container)是页面与数据交互的核心组件,可直接查询数据并展示。常用的数据容器有表格、表单、数据列表、数据详情

image-20221024182513601

2. 适用场景

适用于页面与数据交互的场景,如展示用户列表、用户详情、新建订单、更新订单。如访客预约申请中,提交申请、查询不同状态的申请列表,查询申请单详情等。

3. 基础功能

3.1 常用数据容器功能介绍

常用的数据容器有数据列表、数据详情。各组件能力如下:

组件
基础能力更多功能使用示例
数据列表查询多条数据 循环展示
返回数据可供容器下的任意组件使用
筛选、排序、分页;
数据详情查询一条数据
返回数据可供容器下的任意组件使用
筛选、排序
表格查询多条数据、表格展示列配置、搜索、筛选、排序、分页
表单容器新增、更新、查看数据表单数据联动

3.2 数据容器支持的数据源类型

目前支持的数据来源有:数据模型、APIs,后续将支持变量。

注意:调用 APIs 时,需要按照入参和出参要求设置,否则配置不生效。详细见每个数据容器组件的参数限制。

3.3 文本等其他组件如何绑定数据

数据容器是一个数据提供器,所提供的数据,可供所有业务组件使用。具体用法如下:

将需要绑定数据的组件拖入数据容器内,点击「绑定字段」,即可选择数据容器的数据。

3.4 数据容器和变量是什么关系?

数据容器向上连接展示组件,向下对接数据来源,将数据与页面组件深度融合。简化了数据操作。因此常规的新增、更新、查询等数据交互,推荐使用数据容器。

变量适用于专业开发者自定义代码时,进行数据存储。或某些需要全局变量一次存储的场景。

3.5 使用数据容器类组件,一定要将组件放在数据容器类组件内部么?

数据容器(Data Container)是页面与数据交互的核心组件,它能直接查询并展示数据。在我们的平台中,有多种数据容器组件可供选择,如数据列表(ListView)、数据详情(DataView)、表单容器(WdForm)以及数据表格(WdTable)。

数据容器可实现数据与页面组件的深度整合。这大大简化了数据操作流程。除了提供数据,数据容器还支持常见的页面交互功能,例如分页加载、加载状态以及错误提示等。

在使用数据容器时,若组件依赖于数据容器返回的数据,建议将组件置于数据容器类组件内部。例如,若要展示某条数据详情中的某个字段的图片,将组件放在相应的数据容器内部会更好。这样,数据容器可以自动处理加载中、加载失败等情况,无需关注渲染时机。

如果只需使用数据容器获取数据,而无需进行 UI 交互,您可以直接使用 Query 功能来查询数据。

3.6 使用说明

数据容器的使用如下:

  1. 添加一个数据容器
  2. 选择数据源
  3. 将其他需要绑定数据的组件,拖入容器内。点击「绑定数据字段」,即可选择数据容器的数据。

img

详细用法见各个组件的使用示例,您也可以在创建应用时,选择「访客预约」模板进行体验增、删、改、查的能力。

数据列表组件使用示例

数据详情组件使用示例

表格组件使用示例

表单组件使用示例