单一记录

  少于1分钟  

1.控件简介

单一记录属于数据控件之一，具有数据收集、校验和提交等功能，是展示实体单条数据的起点，通常包含各种有输入值或选中值的组件，例如单行文本、日期选择、下拉框等。常用于调查问卷填写、基础资料填报、单据信息填写等场景。

在一些较复杂的业务场景中，经常会遇到需要管理单项主记录及其相关的子记录的情况。为了有效实现这种主从数据的录入和管理，在用户界面设计中，单一记录通常与重复表或重复节控件结合使用。这种设计允许用户在一个统一的视图中添加、修改或删除子记录，同时保持与主记录的关联。

2.属性

组件通用属性说明，请参见组件通用属性说明。

• 实体

单一记录展示数据的来源。实体属性具备与多种数据源建立关联的能力，其中最为普遍的是实体数据源。这种数据源可以绑定当前应用自定义的实体，或跨应用的实体。基于实体数据源，数据控件便能够在应用程序内执行全方位的数据操作，包括但不限于数据的检索、新增、修改以及删除等。

实体属性可以关联多种数据源，数据源详情信息，请参考：空链接。

• 隐藏字段

基于性能优化角度，数据控件在进行数据加载时，仅会检索页面中关联了录入控件或表格列的字段。然而，在实际业务中，有些字段数据可能用于页面逻辑处理，但又不希望在用户界面中展示。针对这种场景，平台引入了“隐藏字段”属性，该属性中勾选的字段，无需关联前端控件，但数据加载时仍会获取对应字段值。

• 条件

定义一组过滤规则的条件编辑器，以便在数据展示时仅显示满足特定条件的数据项。

单一记录中条件属性较为特殊，单一记录是用于精准展示实体中指定数据项的数据控件。在查看或编辑详情时，需明确该数据项的具体指向，平台中系统默认采用数据ID来唯一标识并定位每条数据，该设置是自动的，无需用户手动配置。但若需根据其他唯一字段来定位数据，设计师可自定义设置。然而，自定义设置时必须确保所选条件能够精确匹配到单一数据记录。如果所设置的条件对应了多条数据，系统将无法展示并会报错默认不加载。

• 分辨率设置

分辨率设置是确保用户界面元素在不同屏幕尺寸和分辨率下保持可用性和视觉一致性的过程。单一记录的分辨率设置支持自适应和固定宽度两种模式。

自适应：可以设置单一记录与视口或父容器的宽度占比，以及阈值宽度。

固定宽度：宽度可设置为特定的像素值，使得单一记录在不同设备屏幕上展现出统一的尺寸，不随视口或父容器大小调整而变化。

• 边距设置

边距设置是用于控制元素之间空间布局的属性，分为内部元素间隔、内边距、外边距三类配置。

内部元素间隔：是指组件内部元素之间的距离。分为行间隔和列间隔，单位为px。

内边距：是指组件内部元素与边框之间的距离。设置组件的内边距会在组件内边框周围创建一个空白区域，使内容与边框之间有一定的距离。单位为px，可设置上下左右四个方向。

外边距：是指组件与其他组件之间的距离。设置组件的外边距会在组件周围创建一个空白区域，使组件与其周围的组件产生一定的间距。单位为px，可设置上下左右四个方向。

3.事件

• 数据加载后：当数据控件数据加载完成后触发。

  

4.风格

• 高度

自适应：指高度根据内容自适应。

固定值：指设定固定高度，当内容超过固定高度时，控件内将出现纵向滚动条。当父级容器小于控件高度时，父级容器出现纵向滚动条。

• 伸缩

自动拉伸： 指父级容器主轴有剩余空间时，子控件可拉伸填满剩余空间，当子控件的内容超过剩余空间时，父级容器出现滚动条。

自动缩小：当父级容器主轴剩余空间不够时，子控件自动缩小，子控件可能出现滚动条。

5.场景示例

5.1场景描述

已有实体“供应商”，希望在表单验证通过后创建对应数据项。

5.2操作步骤

1、创建详情页面，页面名称“供应商详情页”，页面类型选择“详情页”，页面对应实体选择“供应商”，单击确定，创建页面。

2、控件库中选择“单一记录”，往画布区拖入控件，控件属性区中单击“实体”属性。

3、实体属性弹窗中，选择“供应商”实体，右侧选择需要展示的字段，设置控件生成逻辑，单击确定，完成配置。

4、查看自动生成内容，布局是否符合需求，不符合可自行调整。

5、设置字段页面校验：①必填：由于必填已在实体处设置，页面将自动设置；②手机号校验：选择“联系方式”字段，属性校验分组输入类型“手机号码”。

6、控件库中选择“工具栏”，往画布区拖入控件，控件属性区中设置对齐方式为居中。

7、设置“立即创建”按钮：操作1名称修改为“立即创建”，点击“编辑”图标，设置“保存记录”行为，实体选择“供应商[单一记录]”。

8、保存页面，完成详情页创建。

9、创建对应列表页，并创建与详情页关联关系，完成后测试发布应用。

5.3效果演示