低代码列表设计实操：3 大配置模块 + PC/APP 差异，数据展示更精准

JNPF后台常收到类似疑问：

• 列表怎么设置默认排序？

• APP 端为啥不显示复杂表头？

其实 “列表设计” 是控制数据展示效果的关键，今天把列表属性、字段配置的细节拆透，再讲清 PC 和 APP 端的差异，帮你避开配置中的 “隐形坑”。

列表设计的核心定位与操作入口

“列表设计” 不是独立模块，而是依附于 “表单” 或 “视图” 的配置环节 —— 在创建表单（列表表单模式）或视图时，完成基础设计后，点击 “下一步” 就能进入列表设计页面。它的核心作用是 “控制数据怎么展示”，比如哪些字段显示、是否分页、能不能导出数据。

页面默认分 “查询字段”“列表字段”“列表属性” 三大块，还能切换 “PC 端 / 移动端” 分别配置（两者差异很大，后面重点讲），每个配置项都有明确的开关和参数，跟着步骤来基本不会错。

核心操作：3 大模块配置分步拆解（附差异说明）

列表设计的操作围绕 “列表属性（控制整体样式）”“列表字段（控制显示哪些列）”“查询字段（控制怎么搜数据）” 展开，按模块拆解如下：

1. 列表属性：控制列表整体样式（重点看 PC/APP 差异）

列表属性决定列表的整体交互和展示效果，很多配置在 APP 端不生效，先记清关键配置项和差异：

• 列表布局：支持 “普通表格”（默认）和 “分组表格”（按某字段分组展示），APP 端不支持，只能显示普通表格；

• 复杂表头：可合并单元格（如把 “姓名、部门” 归到 “基本信息” 下），APP 端不支持，会自动拆成普通表头；

• 默认排序：PC 和 APP 可分别设置（如 PC 按 “创建时间降序”，APP 按 “名称升序”），选好排序字段和顺序，列表加载时会自动排序；

• 分页设置：PC 端：默认开启，可设 20/50/80/100 条 / 页，若接口是 “真分页”（接口自带分页逻辑），分页设置会锁定，无法关闭；APP 端：分页无效，会显示全部数据，分组表格不支持分页；

• 导出按钮：勾选后列表会显示 “导出” 按钮，支持导出 “当前页”“全部页” 或 “当前选择数据”（需设置视图主键），导出字段可自定义，且按钮文字会随系统语言自动翻译（如简体 “导出”→英文 “Export”）；

• 合计配置：对数字类字段（如金额、数量）求和，显示在列表底部，APP 端和分组表格不支持。

避坑提醒：设置 “视图主键” 后，导出才会显示 “当前选择数据” 选项，主键要选接口返回的唯一字段（如 “员工 ID”），否则导出会出错。

2. 列表字段：控制显示哪些列（PC 更灵活）

列表字段决定哪些数据列显示在列表中，PC 和 APP 配置权限不同：

• PC 端：勾选字段后，可自定义 “列名”（如把 “F_Real_Name” 改 “姓名”）、“冻结”（固定某列不随滚动条移动，适合关键字段如 “ID”）、“对齐方式”（左 / 中 / 右对齐）、“宽度”（手动输入或拖拽调整）；

• APP 端：只能勾选字段和修改 “列名”“排序”，无法设置冻结、对齐和宽度，会自动适配手机屏幕；

• 操作逻辑：把不需要的字段取消勾选，列表就不会显示，拖动字段可调整列的顺序（PC 和 APP 各自独立调整）。

3. 查询字段：控制怎么筛选数据（输入类型有规则）

查询字段是列表顶部的筛选条件，比如 “按姓名搜员工”“按日期搜订单”，配置时要注意 “输入类型” 规则：

• 接口参数生成的查询字段：输入类型由接口参数类型决定（如 “字符串” 显文本框，“日期” 显日期选择器），无法修改；

• 自定义查询字段：输入类型可手动选（如 “单行输入”“下拉选择”“日期选择”），且有对应的 “条件类型”（如 “单行输入” 支持 “模糊查询”，“下拉选择” 支持 “等于查询”）；

• 是否多选：部分字段（如下拉选择、组织选择）默认支持多选，可勾选 “是否多选” 控制，多选后筛选条件会按 “或” 逻辑匹配（如选 “行政部、财务部”，会显示两个部门的数据）。

避坑要点：4 个常见问题解答

1. APP 端看不到复杂表头？正常现象，APP 端不支持复杂表头，会自动拆成普通表头，若需在 APP 端清晰展示，建议在 PC 端就用普通表头，避免合并单元格。

2. 导出时没有 “当前选择数据” 选项？没设置 “视图主键”，进入 “列表属性 - 视图主键”，选择接口返回的唯一字段（如 “订单 ID”），保存后导出就会显示该选项。

3. 分页设置无法关闭？接口是 “真分页”（接口自带 page、size 参数），系统会锁定分页设置，只能通过接口调整分页逻辑，无法在列表设计中关闭。

4. 合计配置不生效？先检查字段类型（必须是数字类字段，如 “金额”“数量”），再确认不是分组表格（分组表格不支持合计），且没在 APP 端查看（APP 端不支持合计）。

列表设计的核心是 “分清 PC/APP 差异，按需配置”：PC 端可做复杂表头、冻结列、分页，适合精细化展示；APP 端以简洁为主，优先保证基础数据可见。比如做 “员工列表”，PC 端设复杂表头 + 分页 + 合计，APP 端简化成普通表头 + 关键字段，兼顾不同端的使用体验。如果遇到配置不生效、导出出错等问题，欢迎在评论区留言，我会帮你分析解决～