Skip to content

@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 类型或字段类型自动识别
AaTEXT普通文本
🛡️SAFE_TEXT1.12.11+文本中含脚本/标签时不渲染,防 XSS
42NUMBER数值展示
✓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 位小数);统计值未知时显示 -。

贡献者

The avatar of contributor named as YuePeng YuePeng

页面历史

Released under the Apache-2.0 License.