@View
配置字段在列表表格中的列展示行为,包括列名、宽度、展示类型、排序等。
属性说明
| 属性名 | 描述 |
|---|---|
title | 表格列名称 |
desc | 列描述 |
type | 数据展示类型,默认 AUTO,详见下方类型表 |
show | 是否显示,默认 true |
sortable | 是否支持点击列头排序,默认 false |
group | 表头分组:相邻且 group 相同的列合并到同一个上级表头,形成多级表头(2.3.0+) |
export | 是否包含在 Excel 导出中,默认 true |
width | 列宽度,需带单位,如 200px、20% |
column | 字段为对象类型时,指定要展示的属性名(@ManyToOne 场景常用) |
className | 表格列的 CSS 类名 |
tpl | 弹出自定义模板,模板中可用 row 变量获取当前行数据 |
ifRender | 动态控制列是否渲染(ExprBool),详见 ifRender 动态渲染 |
template | 列值格式化模板(前端 eval 执行的 JS 表达式),可用变量:value(当前值)、item(整行数据)、item.xxx(某列值) |
statistic | 列统计:COUNT / DISTINCT_COUNT / SUM / AVG / MAX / MIN,在表格底部显示该列在整个查询结果上的统计值,默认 NONE,详见 statistic 列统计(2.4.0+) |
展示类型(ViewType)
文本与数值12
✨
AUTO根据 @Edit 类型或字段类型自动识别Aa
TEXT普通文本🛡️
SAFE_TEXT1.12.11+文本中含脚本/标签时不渲染,防 XSS42
NUMBER数值展示✓
BOOLEAN布尔值展示■
COLOR以色块展示十六进制颜色值;编辑类型为 COLOR 时自动推断★
ICON2.3.0+按 Font Awesome 类名渲染图标⋮
KEY_VALUE2.3.0+JSON 对象按「键: 值」标签逐对展示••••
PASSWORD2.0.4+密码掩码展示,实际值以占位符替代,不会下发到客户端📅
DATE日期格式化展示🕐
DATE_TIME日期时间格式化展示PROGRESS2.0.4+进度条展示;编辑类型为 SLIDER 时最大值取 SliderType.max,否则为 100图像与媒体6
🖼️
IMAGE图片👤
AVATAR2.3.0+圆形头像缩略图,表格 32px、详情 120px,为空时显示默认剪影🖼️
IMAGE_BASE64Base64 编码图片▦
QR_CODE二维码📍
MAP地图展示⚡
SWFFlash 动画链接与附件5
🔗
LINK新窗口打开链接🔗
LINK_DIALOG对话框打开链接⬇️
DOWNLOAD直接下载📎
ATTACHMENT新窗口打开附件📎
ATTACHMENT_DIALOG对话框打开附件富内容渲染5
</>
HTML渲染 HTML 片段📱
MOBILE_HTML以手机屏幕尺寸渲染 HTML{ }
CODE代码高亮展示M↓
MARKDOWNMarkdown 渲染展示▤
TAB_VIEW一对多/多对多子表格展示group 多级表头 v2.3.0+
相邻且 group 值相同的列会被折叠到同一个上级表头之下,形成两级表头:
java
@EruptField(views = @View(title = "单价", group = "金额"))
private BigDecimal price;
@EruptField(views = @View(title = "数量", group = "金额"))
private Integer quantity;
@EruptField(views = @View(title = "合计", group = "金额"))
private BigDecimal total;group 文本与 title 一样会经过多语言翻译;固定列(fixed)以及组内只有一列的「孤立成员」不会被分组;列设置面板仍按平铺的列列表操作,不受分组影响。
statistic 列统计 v2.4.0+
给列声明 statistic 后,表格底部出现一行统计栏,显示该列的统计值。统计的范围是列表查询命中的全部记录,而不是当前页:搜索条件、@Filter、链接树筛选都会影响统计结果,翻页不会。
java
@EruptField(views = @View(title = "金额", statistic = View.Statistic.SUM))
private BigDecimal amount;
@EruptField(views = @View(title = "数量", statistic = View.Statistic.AVG))
private Integer quantity;
@EruptField(views = @View(title = "客户", statistic = View.Statistic.DISTINCT_COUNT))
private String customer;| 值 | 描述 |
|---|---|
NONE | 不统计(默认) |
COUNT | 非空值的个数 |
DISTINCT_COUNT | 去重后的非空值个数 |
SUM | 求和,适用于数值列 |
AVG | 平均值,适用于数值列 |
MAX | 最大值 |
MIN | 最小值 |
工作方式
- 前端在加载列表的同时调用
POST /erupt-api/data/aggregate/{erupt},入参与列表接口相同(TableQuery:搜索条件、链接树值、视图编码),返回「列名 -> 统计值」 - JPA 数据源把所有统计列合并为一条聚合查询;JDBC、SQLite(设计器)、MongoDB 数据源分别执行各自的原生聚合
- 数据源无法聚合的列(如
@Transient字段、由DataProxy.afterFetch填充的计算列)退化为在内存中统计:最多拉取 2000 条记录计算,超过这个数量时该列显示为未知(null),不会用部分数据给出错误结果;持久化列不受此限制 - 远程节点(erupt-cloud)托管的模型不参与统计
column指向关联对象属性的列(如@View(column = "name"))同样可以统计- 在 TABLE 视图分组 中,声明了
statistic的列还会在每个组头显示该组的小计
TIP
统计栏中的数值按本地化格式显示(千分位分隔,最多保留 2 位小数);统计值未知时显示 -。