# 流程列表

来源快照：`result_data_new_260518.json`

- 来源 ID：`1183977657393618985`
- 模块：低代码平台e-builder
- 目录：页面引擎 - 页面设计器 - 页面组件 - 模块组件 - 模块组件与工作流程
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

## 一、功能背景及价值用途

流程列表组件用于对系统内个人流程数据做展示。通过使用流程列表，用户可在搭建页面中展示不同类型的流程数据，如待办流程、已办流程、草稿流程等，也可以对流程数据按工作流和类型做数据过滤。

## 二、功能概述及使用说明

流程列表整体功能和列表组件基本一致，支持列表样式、显示字段、排序字段、搜索条件、分页模式、自动滚动、数据预加载等通用功能.。同时流程列表扩展支持了流程来源、数据过滤、提醒方式的配置。

### 1.标题和底部

启用标题和启用底部区域是组件的常见配置选项，它们的作用主要是为了增强功能可见性、规范操作流程以及提升用户体验。

[具体功能介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159789715744890921&freepass_doc=1&space_id=1157961794811633670 "具体功能介绍")

### 2.流程来源

流程列表支持通过流程来源配置选择或者排除工作流、工作流类型，来指定需要展示的数据范围，满足用户在不同页面数据展示的差异控制。

其中选择/排除工作流，可指定具体工作流的数据范围；选择/排出工作流类型，可通过工作流类型来限制。在配置来源后，展示数据仅会在指定的数据范围内。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328674453020677&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.展示样式

列表样式主要分为两类：表格式和列表式。表格式用表格的形式展示数据；列表式可以更加自由灵活的排版展示数据。

表格式显示效果：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328674445459475&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

列表式显示效果：

 ![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328678524420098&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 4.显示字段

显示字段功能允许用户根据行业特性、需求场景自定义字段的展示方式（如字段显示布局、字段字体样式等），实现字段自由设计与展示，满足复杂业务数据个性化展示需求。

[具体功能介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1160523773019652097&freepass_doc=1&space_id=1157961794811633670 "具体功能介绍")

### 5.数据过滤

流程列表支持通过数据过滤配置流程类型来便捷的对流程数据做过滤展示，支持常用的待办流程、草稿流程、已办流程、共享给我的流程等类型。

同时支持单条工作流过滤，允许在选择流程分类过滤后，对分类中展示的工作流做进一步精细的过滤。

对于常用的待办流程，额外提供了显示抄送、显示转发、显示退回、显示传阅、优先显示超时流程的配置项。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328678524420109&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 6.排序字段

排序功能是提高数据查询效率、优化用户体验的基础工具。

[具体功能介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159790879839256584&freepass_doc=1&space_id=1157961794811633670 "具体功能介绍")

### 7.搜索条件

搜索条件，支持灵活自定义搜索内容，快速筛选出契合需求的组件数据。

[具体功能介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1160524378477535243&freepass_doc=1&space_id=1157961794811633670 "具体功能介绍")

### 8.其他

#### 8.1.每页行数

每页行数为列表单页显示的最多数据条数。默认为每页10条，可选5、10、20、50、100、和自定义分页（自定义分页最小显示为1，最大显示为200）。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328678732038158&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 8.2.显示总数

显示总数为在列表标题后显示当前列表总共有多少条数据，默认不显示。如果列表没开启标题栏，则无法显示。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328683037491209&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 8.3.数据预加载

数据预加载可提高列表数据渲染速度。如果列表使用的数据源更新频率较低，或对列表显示数据实时性要求不高，可以开启数据预加载以提高渲染速度。

数据预加载默认关闭。开启后，会将列表数据缓存在前端，下一次加载时将优先使用缓存中数据进行渲染，待后端接口获取最新数据后再进行渲染更新。实际效果第一次预览/运行列表会显示加载效果，后续再次打开时，不重新加载数据（不显示加载效果）。

#### 8.4.自动滚动

该配置仅支持PC端。自动滚动可配置列表每间隔多少时间滚动多少条数据。默认关闭，开启后需要配置滚动方向、滚动间隔时间和滚动条数。

页面运行时如果列表当前高度能显示全当前页数据，则不会触发自动滚动。只有列表数据产生滚动时，自动滚动才会生效。

#### 8.5.分页模式

分页模式为列表切换分页数据的方式。默认为页码分页，可选页码分页、点击加载更多、滚动分页和隐藏分页。

 ![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328682892787745&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

页码分页：列表样式为表格式可以展示分页及页数切换（移动端仅展示分页）；列表式仅展示分页。

点击加载更多：列表底部展示加载更多按钮，点击后会根据每页行数，加载出一页的数据（剩余数据少于一页，则加载少于一页的数据）。

滚动分页：当组件本身有滚动条，且有数据没有加载时，滚动列表会根据每页行数，加载出一页的数据（剩余数据少于一页，则加载少于一页的数据）。移动端组件默认高度为数据高度，如果需要使用滚动分页，则需要搭配高度配置使列表产生滚动条。

隐藏分页：选择后不显示分页。

#### 8.6.定时刷新

定时刷新可设置列表每隔多长时间进行一次数据更新。默认不刷新，可以设置不刷新、3分钟、5分钟、10分钟、可自定义刷新时间（单位：分钟）。自定义刷新时间最小可设置为3分钟。

对于一些长时间不关闭或刷新的展示页面，但是需要实时更新列表数据时，可配置定时刷新来及时更新展示数据。

#### 8.7.高度

该配置仅支持移动端。移动端列表高度是根据数据自适应的，数据越多高度越高，如果想控制列表固定高度，可通过高度配置列表显示高度。高度默认为不固定高度，可选不固定高度、固定高度、铺满屏幕。

不固定高度：按照组件内容高度展示。固定高度：可设置具体的高度值，单位为px。铺满屏幕：设置之后组件高度展示为屏幕高度。

#### 8.8.提醒方式

流程列表通过提醒方式配置可以对未读流程做提示，支持设置红点图标，支持对标题做加粗、斜体和字体颜色的配置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328687154200581&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 三、上下游关联功能点

1、

[显示字段](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1160523773019652097&freepass_doc=1&space_id=1157961794811633670 "显示字段")

2、[组件标题和底部](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159789715744890921&freepass_doc=1&space_id=1157961794811633670 "组件标题和底部")

3、[排序字段](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159790879839256584&freepass_doc=1&space_id=1157961794811633670 "排序字段")
