1 总体介绍

在苍穹开发平台设计器中，平台为每种类型的页面都提供了页面属性，用于实现表单的整体属性配置、表单内规则的统一管理、表单在系统功能模块中的应用等功能。

单据列表可在创建单据时一起被创建。单据列表的字段只能是对应表单中的字段，记录表单中字段值的流水数据，主要用于展示与查询数据。

单据列表的控制主要包括列表属性和列表控制：

• 列表属性：过滤控件属性，列表页面属性，单据模板列表属性，表格视图属性，卡片视图属性，列表字段属性。

• 列表控制：自定义调整列表的列显示。

说明：部分属性的配置方法在表单中通用，请参考动态表单属性介绍。

2 配置路径

列表页面设计器中，可以通过以下两种方法选中列表属性：

• 选中“列表页面属性”方法一：【大纲】>【列表的名称】；

• 选中“列表页面属性”方法二：选中设计器底部面包屑的根节点（即列表的名称）。、

• 选中“单据模板列表”：【大纲】>【单据模板列表】；

• 选中“表格视图”：【大纲】>【表格视图】；

• 选中“卡片视图”：【大纲】>【卡片视图】；

• 选中“列表字段”：直接在列表表格中“添加字段”，添加后，选中想要的字段即可。

配置“列表控制”时，需要先运行列表，选中齿轮形状的“列表控制”图形按钮进入。

3 列表页面属性

3.1 列表插件

3.1.1 功能介绍

列表支持插件扩展开发，单据列表插件基类是kd.bos.list.plugin.AbstractListPlugin。

详情查看标准单据列表插件。

3.2 列表选项

3.2.1 功能介绍

对于用户界面【列表控制】的选项参数，如需添加其他业务参数以及修改参数默认值，开发者可通过扩展或继承列表选项参数的基对象模板实现。

设计器配置：如对列表选项参数进行了继承，对选项参数进行了修改，希望能应用在某一列表上，可到列表设计器找到【列表选项】属性，绑定所继承的列表选项参数表单。

3.3 列表表单模板

3.3.1 功能介绍

列表表单模板提供了如下功能：PC端单据列表布局使用的模板，可更换为自行设计的动态表单页面。

在部分业务需求场景中，例如，复杂的单据列表界面需求依靠标准的单据列表模板（bos_list）实现不了。此时，则可通过新建空白动态表单，添加单据列表等控件，进行自定义开发，然后将该动态表单页面的编码填写至该项属性中，从而实现需求。

注意：更换列表表单模板为非bos_list后，如果当前列表表单模板不包括bos_list的某些控件，则这些控件在设计器列表页面的改动将不会生效。

例如：当前列表表单模板不包括过滤控件，那么在设计器的列表页面中，向快速过滤/方案过滤/常用过滤中添加筛选字段时，将不会生效。

3.4 打开方式

3.4.1 功能介绍

控制主菜单上操作的打开方式，含新页签和模态显示两种方式。

• 在“新页签”下，打开列表中的一条单据，会以新增页签的方式展开；

• 在“模态显示”下，打开列表的一条单据，会以弹出框的形式呈现（模态显示）。

3.5 允许双击打开

3.5.1 功能介绍

开启该属性后，在运行态单据列表界面，双击一条单据数据所在行的任何位置，可进入其详情界面。

关闭时，只能通过点击单据编码查看单据数据。

4 单据模板列表属性

4.1 分页条数

4.1.1 功能介绍

控制表格视图中每页展示记录的数量，可选：5条/页、10条/页、20条/页、50条/页、100条/页、500条/页、1000条/页、10000条/页，默认20条/页。

4.2 缺省视图

4.2.1 功能介绍

设置单据列表界面在运行态默认展示的视图，可选：表格视图、卡片视图、轻分析视图。

注意：请在此处更改列表显示的视图类型。

4.3 已选合计字段

4.3.1 功能介绍

在运行态单据列表界面，将选中记录的已选合计字段值汇总并展示到列表左上角。

4.4 过滤条件

4.4.1 功能介绍

设置列表的过滤条件。

4.5 多选

4.5.1 功能介绍

控制单据列表是否支持多选。当多选启用时，可以在运行时勾选列表中多个选项，可用于引出等需求操作。

5 表格视图属性

5.1 标识

5.1.1 功能介绍

表格视图的标识和其他页面一样，用于页面在唯一性辨识。

注意：表格视图标识默认为gridview，不要修改！如修改了“列表表单模板”属性，请注意：“列表表单模板”属性所绑定的动态表单页面中的单据列表的表格视图的标识一定要为gridview，否则数据显示不出来！

5.2 显示列选择

5.2.1 功能介绍

在运行态单据列表界面是否显示选择列，默认启用。

5.3 界面规则

5.3.1 功能介绍

目前只支持设置字段显示样式。

5.4排序与过滤

5.4.1 功能介绍

可选：允许排序和过滤、禁止排序和过滤。默认允许排序和过滤。

在运行态单据列表界面，移动鼠标悬浮在列表头上即可显示过滤漏斗图标，点击列表头即可按升序/降序排列表格数据。

5.5 单头显示

5.5.1 功能介绍

设置分录字段在折叠卡片中显示。

5.6 折叠表单

5.6.1 功能介绍

设置表单详情在折叠卡片中显示。启用“单头显示”属性后方可设置该属性。

注意：该属性配置的表单必须为单据列表绑定的单据实体。

5.7 分页类型

5.7.1 功能介绍

设置列表分页的展示风格，分为：基础、简化、少页、精细。默认是基础。

6 卡片视图属性

6.1 布局方式

6.1.1 功能介绍

设置单据卡片的显示排布方式。

• 当选择流式布局时，卡片会在一排放置满后自动换行排布；

• 当选择横向滚动布局时，所有的卡片放置在同一行，通过页面底部滑动条左右滚动查看。

7 列表字段属性

7.1 初始排序方式

7.1.1 功能介绍

设置页面加载时是否需要按该字段进行排序，可选：不排序、升序、降序。该属性需结合“支持排序过滤”属性结合使用。如列表多个字段均设置了该属性，则按照字段的位置顺序进行排序。

7.2 汇总方式

7.2.1 功能介绍

设置数字类字段的汇总方式，可选：不汇总、合计。

请注意“已选合计字段”和“汇总方式”两个属性对应的功能的差异！

8 列表控制

8.1 功能介绍

在运行态单据列表界面，点击右上方的小齿轮图标即可进入列表控制界面。

此设置是个人依据其习惯进行的个性化配置。