列表属性

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.