模板单元格
模板单元格类型是在报表插件的模板中有效地组织数据的有用设置。
例如，如果你想创建基于行的报告，可以使用’列表 / List‘单元格类型，或者如果你想创建销售摘要报告，可以使用‘分组 / Group’和‘汇总 / Summary‘单元格类型。
要在报表插件的模板中配置模板单元格类型，请使用setTemplateCell方法，并指定类型和绑定属性的值。
以下是所有支持的单元格类型列表：
静态单元格 / StaticCell
列表单元格 / ListCell
分组单元格 / GroupCell
汇总单元格 / SummaryCell
以下代码示例展示了如何为报告中的单元格设置不同的模板单元格类型：
// LIST REPORT.
const columns = ['orderId', 'orderDate', 'freight', 'customerId','shipName', 'shipCity', 'shipCountry'];
columns.forEach((columnName, i) => {
templateSheet.setValue(0, i, `${columnName[0].toUpperCase()}${columnName.substring(1)}`);
templateSheet.setTemplateCell(1, i, {
type: 'List',
binding: `Orders[${columnName}]`,
});
});
// GROUP and SUMMARY REPORTS.
templateSheet.addSpan(1, 0, 2, 1);
templateSheet.setTemplateCell(1, 0, {
type: 'Group',
binding: 'Orders[CustomerId]',
});
templateSheet.setTemplateCell(1, 1, {
type: 'Group',
formula: '=YEAR([@orderDate])',
binding: 'Orders[OrderDate]'
});
templateSheet.setTemplateCell(1, 2, {
type: 'Summary',
binding: 'Orders[Freight]',
});
// LIST, GROUP, and SUMMARY REPORTS
templateSheet.setTemplateCell(0, 0, {
type: 'Group',
binding: `Sales[Region]`,
});
templateSheet.setTemplateCell(0, 1, {
type: 'Summary',
binding: `Sales[Sales]`,
aggregate: 'Sum',
});
templateSheet.setTemplateCell(0, 2, {
type: 'List',
binding: `Sales[Salesman]`,
});请注意，SpreadJS 表格设计器还通过其模板设置提供此配置。
通过此设置，您可以从单元格属性面板的“类型”部分中选择所需的单元格类型。
根据所选的单元格类型，设置选项将有所不同。
分组单元格是基础数据单元格的扩展，其中包括用于高级分组的附加属性。
高级分组允许用户根据条件规则或公式计算的结果对数据进行分组。此功能增强了报表插件中的数据组织能力。
使用IGroupBin接口的bins和formula属性，您可以在分组单元格中定义额外的高级分组选项。
属性 | 描述 | 示例代码 |
|---|---|---|
高级分组(规则/bins) 用户可以添加多个自定义组规则以匹配不同的记录。 | ||
名称 / caption | 代表分组结果中显示的名称 | sheet.setTemplateCell(1, 0, { binding: "Sales-NY[Sales]", type: "Group", bins: [ {caption: "Sales <= 200", groupBy: "=([@Sales] <= 200)"}, {caption: "Sales > 200 && Sales <= 500", groupBy: "=AND([@Sales] > 200, [@Sales] <= 500)"}, {caption: "Region", groupBy: "[@Region]"}, ] }); |
规则：公式条件类型 [formula condition] | 按公式结果对数据进行分组 | sheet.setTemplateCell(1, 0, { binding: "Sales-NY[Sales]", type: "Group", bins: [ {caption: "Sales <= 200", groupBy: "=([@Sales] <= 200)"}, {caption: "Sales > 200 && Sales <= 500", groupBy: "=AND([@Sales] > 200, [@Sales] <= 500)"}, {caption: "Sales > 500", groupBy: "=([@Sales] > 500)"}, ] }); |
规则：列 [field] | 按字段值对数据进行分组 | sheet.setTemplateCell(1, 0, { binding: "Sales-NY[Sales]", type: "Group", bins: [ {caption: "Sales <= 200", groupBy: "=([@Sales] <= 200)"}, {caption: "Region", groupBy: "[@Region]"} ] }); |
规则：空字符串 [blank string] | 表示不匹配其他条件的记录的默认组 | sheet.setTemplateCell(1, 0, { binding: "Sales-NY[Sales]", type: "Group", bins: [ {caption: "Sales <= 200", groupBy: "=([@Sales] <= 200)"}, {caption: "Sales > 200 && Sales <= 500", groupBy: "=AND([@Sales] > 200, [@Sales] <= 500)"}, {caption: "Others", groupBy: ""} // match the remaining records. ] }); |
满足时停止 / stopIfTrue | 确定在找到匹配项后分组是否应停止。默认值是true | sheet.setTemplateCell(1, 0, { binding: "Sales-NY[Sales]", type: "Group", bins: [ {caption: "Sales <= 200", groupBy: "=([@Sales] <= 200)"}, {caption: "Sales > 200 && Sales <= 500", groupBy: "=AND([@Sales] > 200, [@Sales] <= 500)", stopIfTrue: false}, {caption: "Sales >= 500", groupBy: "=([@Sales] >= 500)"}, ] }); |
始终可见 / alwaysVisible | 确定与任何记录都不匹配的组是否不会显示在结果中，因为它是没有记录的空白组 | sheet.setTemplateCell(1, 0, { binding: "Sales-NY[Sales]", type: "Group", bins: [ {caption: "Sales < 0", groupBy: "=([@Sales] < 0)", alwaysVisible: true}, {caption: "Sales <= 200", groupBy: "=([@Sales] <= 200)"}, {caption: "Sales > 200 && Sales <= 500", groupBy: "=AND([@Sales] > 200, [@Sales] <= 500)"}, {caption: "Sales > 500", groupBy: "=([@Sales] > 500)"}, ] }); |
高级分组(公式/formula) 用户可以使用公式计算所有记录，然后根据公式计算结果进行分组 | ||
公式 / formula | 根据表字段的计算值对数据进行分组 | sheet.setTemplateCell(1, 0, { binding: "Orders[orderDate]", type: "Group", formula: "=YEAR([@orderDate])" }); sheet.setTemplateCell(1, 1, { binding: "Orders[orderDate]", type: "Group", formula: "=MONTH([@orderDate])" }); |
type=warning
注意：
高级分组规则中的公式支持静态值和结构引用，例如`[@columnName]`
不支持单元格引用
在高级分组公式中，只能使用单元格绑定表中的列字段