优化 table 中 `totalRow` 表头属性介绍

pull/1315/head
贤心 2023-08-05 10:34:06 +08:00
parent 0edfe2847c
commit b7e507d054
1 changed files with 23 additions and 23 deletions

View File

@ -205,7 +205,7 @@ table.render({
</tr> </tr>
<tr> <tr>
<td>exportTemplet <sup>2.6.9+</sup></td> <td>exportTemplet <sup>2.6.9+</sup></td>
<td> <td colspan="3">
<div class="ws-anchor" id="cols.exportTemplet"> <div class="ws-anchor" id="cols.exportTemplet">
@ -223,8 +223,6 @@ exportTemplet: function(d, obj){
``` ```
</td> </td>
<td>string<br>function</td>
<td>-</td>
</tr> </tr>
<tr> <tr>
<td> <td>
@ -232,21 +230,31 @@ exportTemplet: function(d, obj){
[totalRow](#cols.totalRow) [totalRow](#cols.totalRow)
</td> </td>
<td> <td colspan="3">
<div class="ws-anchor" id="cols.totalRow"> <div class="ws-anchor" id="cols.totalRow">
是否开启该列的自动合计功能。 是否开启该列的自动合计功能,默认不开启
</div> </div>
- 前端合计 - **采用前端合计**
{{!
``` ```
totalRow: true // 开启合计行,并默认对当前所有行数据进行前端合计 // 开启并输出合计行前端合计结果
totalRow: true
// 开启并输出合计行自定义模板。此处 TOTAL_NUMS 即为合计结果的固定特定字段
totalRow: '{{= d.TOTAL_NUMS }} 单位'
// 取整或其他运算
totalRow: '{{= parseInt(d.TOTAL_NUMS) }}'
``` ```
!}}
- 后端合计 注意:*合计行模板仅支持字符写法,不支持函数写法,请勿与 `templet` 用法混淆。*
前端合计的数据有限,因此常常需要后端直接返回合计行结果,此时将优先读取后端的合计行返回结果,其格式如下: - **采用后端合计**
前端合计的数据有限,因此常需要后端直接返回合计结果,组件将优先读取。数据格式如下:
``` ```
{ {
@ -261,26 +269,18 @@ totalRow: true // 开启合计行,并默认对当前所有行数据进行前
} }
``` ```
如上,在 `totalRow` 中返回所需统计的列字段名和值即可。 在合计行自定义模板中输出后端返回的合计数据
<br>`totalRow` 字段同样可以通过 `parseData` 回调来解析成为 table 组件所规定的数据格式。
- 合计行模板
{{! {{!
``` ```
// 获取前端统计的动态字段 // 获取后端接口返回数据中的统计字段。此处 TOTAL_ROW 即对应返回据中的 totalRow
totalRow: '{{= d.TOTAL_NUMS }} 单位' // 还比如只取整:'{{= parseInt(d.TOTAL_NUMS) }}' totalRow: '分数:{{= d.TOTAL_ROW.score }}'
// 获取返回数据中的统计字段
totalRow: '分数:{{= d.TOTAL_ROW.score }}' // TOTAL_ROW 即对应返回据中的 totalRow
``` ```
!}} !}}
</td> 如上,在 `totalRow` 中返回所需统计的列字段名和值即可。
<td>boolean<br>string</td> `totalRow` 字段同样可以通过 `parseData` 回调来解析成为 table 组件所规定的数据格式。
<td>
`false`
</td> </td>
</tr> </tr>