列表控件用于在带有列标题的标准表格网格中显示一组数据。用户可以通过添加行来输入相关字段列表。
列表控件（或说列表字段）作为包含列/字段标题的表格出现在表单上。这些字段标题可以通过编辑其属性来完全自定义。
提示： 字段列表仅适用于表单构建器。它反映了一串 JSON 对象。
使用设计
易企办Yeeoffice 提供了两个用于显示表格数据集的控件：字段列表和内容列表。虽然它们满足类似的用例，但选择在您的设计中使用的正确控件将取决于您需要显示的数据类型。
在以下情况下使用字段列表 ：
- 您希望将其用作结构化行和列的网格表；
- 用户可以通过添加新的行项来输入列值；
- 它是表单上的数据绑定 控件，您可以通过编辑其关联字段来自定义外观和行为。
- 它提供了一些带有汇总表达式的字段，可以与表单上的其他控件绑定。
在以下情况下使用内容列表：
- 灵活的布局来查看每一行（项目）而不是在网格表中收集信息；
- 用户可以通过添加新的页面项来输入值；
- 它是表单上的未绑定 控件，您需要有一个关联的数据列表才能显示。
- 显示的内容可能因过滤条件（在表单和数据列表之间）而异。
列（字段）设置
您需要添加一个或多个特定字段/控件作为其列标题。易企办提供了汇总函数，用于生成各个字段（列）的结果汇总。
- 列设置
大多数易企办内置控件也可以用于 List 控件。它允许从“列设置”添加一些特定的字段。
您可以通过编辑其设置属性（例如基本设置、显示和验证）来自定义每个字段/列。您也可以按等级对它们进行排序。
请注意：如果未选中，您可以隐藏此列表中的某些列。隐藏此字段的动态显示规则只会隐藏此列的值。
- 摘要设置
摘要编辑器提供两种类型的摘要功能：
- Concat（）函数 – 适用于除数字以外的所有类型
- 数值汇总 ( Sum&Average&Min&Max )
您可以在此列表下启用“显示”这些 数字列摘要。
将摘要结果绑定到此主窗体上的另一个相同控件中是可选的 。例如，此列表的数字列应绑定到此形式的数字控件。
- 列表设置的映射列表
每个字段设置适用于其绑定控件。 了解有关基本绑定控件/字段的更多信息。
| 字段类型 | 绑定控制 | 摘要类型 |
| 文本 | 所有输入类型：文本框; 文本区；下拉菜单、单选按钮、复选框；超链接；计算; 评分。 | Concat（）合并多个数组 |
| 数字 | 数字;货币;计算。 | 总和&平均值&最小值&最大值 |
| 布尔值 | 转变;计算。 | Concat（）合并多个数组 |
| 约会时间 | 日期选择器;时间选择器；计算。 | Concat（）合并多个数组 |
| 附件 | 附件;计算。 | Concat（）合并多个数组 |
| 元数据 | 元数据；计算。 | Concat（）合并多个数组 |
| 用户 | 用户;计算。 | Concat（）合并多个数组 |
| 成本中心 | 成本中心;计算。 | Concat（）合并多个数组 |
| 组织 | 组织;计算。 | Concat（）合并多个数组 |
| 地点 | 地点;计算。 | Concat（）合并多个数组 |
| 抬头 | 抬头;计算。 | Concat（）合并多个数组 |
| 图像（图像） | 签名;图像;计算。 | Concat（）合并多个数组 |
| 多个元数据 | 多个元数据；计算。 | Concat（）合并多个数组 |
行（项目）设置
当字段列表不是只读时，有一个易企办默认允许用户添加或删除行。相反，只读列表不允许配置设置或行，它总是应用于任务表单页面。
- 添加行– 它允许用户基于列添加一行或多行。
- 删除行– 它允许用户删除此列表的现有行。
- 允许导入– 易企办允许用户将 xlsx 格式的文件上传到字段列表。
启用“允许导入”后，用户可以选择逐个添加项目，或批量导入以添加多行。
请注意：要处理批量导入，您的列表的每一列标题都应该是唯一的，因此上传文件的第一行应该具有相同的标题名称。
标签和关联变量
标签将显示为该字段的标题。您可以定义此字段列表的名称。您也可以关闭“显示标题”以隐藏此列表的标签。
可以重置字段列表以与此表单上的任何其他列表控件绑定。
显示
定义此字段的外观以更改样式。
- 显示列表的偏好
字段列表有两个显示选项： 列表视图 或卡片视图。您可以根据需要显示的列字段数来选择您的偏好。易企办Yeeoffice提供PC端和移动端之间的默认适配。
用户可以在此列表的右上方切换视图布局。
- 动态显示规则
当您为此字段设置动态显示规则时，它的行为会根据特定条件和规则而有所不同。字段列表控制有四种操作（隐藏/显示/只读/可写）。
了解如何为字段创建动态显示规则提示 ： 编辑此列表的动态显示规则将反映在整个列表中。
- 允许评论
提交表单后，您可以启用/禁用此字段的评论。有两种评论触发方式： 鼠标点击和悬鼠标停。
对于绑定控件，注释键将与此控件/字段自动绑定。
验证
验证将验证用户在此表单中输入的数据是否符合您在提交表单之前指定的标准。
- 只读
将此字段设置为只读以创建您的工作流（或应用程序版本）的可变表单页面。所有绑定的控件（字段）都可以设为只读，默认情况下已经是只读的字段除外。例如计算。
- 必填项
必填字段将确保用户提供响应。如果需要某个字段而用户未填写，则会在该字段下方和表单右上方显示一条提示错误消息。在向字段添加值之前，用户无法提交表单。
必填字段由标签旁边的红色星号 ( * )指示。默认情况下，从不需要字段。
此列表的要求将要求用户在提交表单之前至少提供一项（行）。此列表中的必需列应在其自己的设置属性中启用。
请注意：只有此表单中可见的必填字段才会触发验证操作。
- 自定义验证
您可以设置自定义验证条件为假时，消息显示。当指定条件变为真时，该消息将显示在您的字段下。此功能将允许您添加任意数量的规则来验证您的字段。
了解有关自定义验证的更多信息。