## 任务目标
请设计能够直接支持业务查询和处理的列表页面。选择表格或列表应服务于用户查找与判断。
交付能用于评审或后续实施的具体方案、规则与样例;未要求实施的部分不声称已经落地。
## 输入信息(选填)
两项均可留空,也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表;能读取的内容由执行者补齐。
列表业务:
列表与接口资料:
## 信息不完整时
先使用本次对话中已经说明的信息;用户留空、写“暂无/不清楚”或未替换输入标记,都按缺失处理,不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问,不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料,不为补齐输入擅自扩大操作范围。
### 优先确认
- 核对查询条件、默认筛选、排序、分页参数与服务端统计范围,定位前后端不一致之处。
- 盘点对象标识、关键判断字段、列格式、长内容处理和行内操作。
- 追踪单行与批量动作、跨页选择、部分失败、详情返回和删除末页数据的实际行为。
### 可采用的默认处理
- 保留已有查询和分页契约,优先呈现对象标识、关键状态及主要操作,不凭空新增后端筛选或全量统计能力。
- 已有选择范围沿用明确契约;新拟批量交互先按可见且具备权限的记录设计,跨页全选单列所需接口与业务条件。
- 零、空值、未加载、无权限和加载失败分别表达,长内容可完整查看且不挤掉主要操作。
### 必须有依据的事项
- 筛选或统计口径与接口含义冲突时,不能自行改变结果范围;先完成列、布局和已知状态设计。
- 批量操作的数据边界、权限或部分生效规则不明时,不能把批量处理设计成默认全部成功。
只有缺口会改变业务结果、权限边界或关键实现,且无法从现有资料确认时,才集中提出最多 3 个关键问题;说明影响,并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定,不逐项等待确认。
### 资料仍不足时的交付
- 无工程时依据字段及业务资料交付查询字段表、列定义、单行与批量交互和分页状态规则。
- 没有数据规模或接口证据时交付可核对的布局与异常设计,单列服务端能力缺口,不声称性能验证通过。
## 执行要求
列表要便于扫描、查找和处理,筛选、批量操作及状态规则以当前业务为准。
1. 明确列表的主要任务是查询、比对、审批还是浏览,按任务选择表格或条目列表。将对象标识、判断所需信息和主要操作放在稳定位置,不为了视觉整齐隐藏关键业务字段。
2. 整理查询字段的类型、默认条件、重置结果、联动规则和提交方式。说明日期范围、时区、空值、枚举以及搜索模糊匹配规则,后端不支持的能力标为待实现。
3. 定义列顺序、宽度、对齐、排序依据和截断查看方式,区分业务空值、零、无权限和未加载。金额、计数与时间要有明确格式,长文本可以展开但关键操作必须可见。
4. 定义分页、筛选、排序和进入详情后的上下文保留,说明删除当前页最后一条、查询条件变化与数据刷新时的页码处理。客户端展示逻辑不能冒充服务端全量统计。
5. 设计单行及批量操作,明确选择当前页还是跨页、不可操作记录如何处理、部分成功如何反馈。涉及不同状态或组织的数据时逐项核验可操作范围。
6. 覆盖加载中、查询无结果、首次无数据、接口错误和权限不足状态,并按一次真实查询到处理完成的过程走查。演示记录必须显著标识,不作为正式业务事实。
## 交付与验收
输出:列表任务说明、查询字段表、列定义、单行和批量交互、分页状态规则、异常状态文案、验收用例。每个按钮都说明触发条件、结果和失败后可执行动作。
验收:用户能识别记录并完成核心操作;筛选与结果范围一致;批量操作边界明确;长文本不挤掉按钮;没有把缺失数据显示成零或成功状态。
信息边界:未知的数据规模、接口能力和权限规则保留为待确认项;仅有设计资料时不得报告性能或实际操作已经通过。
### 本条完成检查
- 查询条件、结果范围与统计口径一致,列表记录和主要操作清楚可辨。
- 分页、详情返回、选择范围、部分失败和末页删除有明确处理规则。
- 长文本、空结果、首次无数据、错误及权限不足各有对应呈现,不用零或成功掩盖缺失数据。
按本条要求组织结果,使用简洁中文和一致的编号、术语、缩进及空行;已有项目格式优先。只说明实际完成的内容,将采用的假设、未完成项和缺少的条件写在相关位置,不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注,不宣称已通过或已有性能收益。
## 参考资料与适用边界
参考来源(核验于 2026-09-08):
- [Ant Design 列表页](https://ant.design/docs/spec/research-list-cn/)