概述
本 Demo 展示了如何配置数据透视表的选项,实现自定义的显示效果和交互行为。Demo 提供了可视化界面,用户可以通过勾选框、下拉菜单和输入框动态调整数据透视表的各项选项,实时查看配置效果。
实现思路
在工作表 2 中创建数据源表格,包含销售数据
在工作表 1 中使用数据源创建数据透视表,并传入初始选项配置
配置数据透视表的行字段、列字段和值字段
绑定 UI 控件的点击事件,当用户修改选项时更新数据透视表
通过 pivotTable.options 属性动态修改各项配置
代码解析
创建数据透视表并传入选项
这段代码在创建数据透视表时传入了 option 参数,配置了行标题、列标题和行列带区样式的显示。pivotTables.add() 方法的最后一个参数接收选项配置对象。
动态修改数据透视表选项
这段代码在用户点击"应用"按钮时,读取界面上的所有选项值并更新到 pivotTable.options 对象中。使用 suspendLayout() 和 resumeLayout() 可以批量更新选项,提高性能并避免界面闪烁。
运行效果
打开页面后,左侧显示数据透视表,右侧显示选项配置面板
勾选或取消勾选各个选项后,点击"应用"按钮,数据透视表会实时更新显示效果
可以通过下拉菜单调整总计位置(行、列、两者或无)、分类汇总位置(顶部、底部或无)
可以设置空值显示内容和压缩布局的行标签缩进值
所有修改都会立即应用到数据透视表中
API 参考
pivotTables.add() 方法
name: 数据透视表名称
sourceData: 数据源,可以是表名或范围公式
row、col: 数据透视表的起始位置
layout: 可选,布局类型(compact、outline、tabular)
theme: 可选,主题样式
options: 可选,选项配置对象
options 对象主要属性
bandRows: 是否显示交替行样式
bandColumns: 是否显示交替列样式
showRowHeader: 是否显示行标题
showColumnHeader: 是否显示列标题
showDrill: 是否显示展开/折叠按钮
showFilter: 是否显示筛选按钮
grandTotalPosition: 总计位置
subtotalsPosition: 分类汇总位置
missingCaption: 空值显示内容
rowLabelIndent: 行标签缩进值(紧凑布局)
mergeItem: 是否合并并居中标签单元格
window.onload = function () {
let spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 2});
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
let sheet1 = spread.getSheet(0);
let sheet2 = spread.getSheet(1);
let tableName = getDataSource(sheet2, pivotSales);
let pivotTable = initPivotTable(sheet1, tableName);
bindEvent(pivotTable, spread);
spread.resumePaint();
}
function getDataSource(sheet, tableSource){
sheet.name("DataSource");
sheet.setRowCount(117);
sheet.setColumnWidth(0, 120);
sheet.getCell(-1, 0).formatter("YYYY-mm-DD");
sheet.getRange(-1,4,0,2).formatter("$ #,##0");
let table = sheet.tables.add('table', 0, 0, 117, 6);
for(let i=2;i<=117;i++)
{
sheet.setFormula(i-1,5,'=D'+i+'*E'+i)
}
table.style(GC.Spread.Sheets.Tables.TableThemes["none"]);
sheet.setArray(0, 0, tableSource);
return table.name();
}
function initPivotTable(sheet, source){
sheet.name("PivotTable");
sheet.setRowCount(1000);
let option = {
showRowHeader:true,
showColumnHeader:true,
bandRows:true,
bandColumns:true
};
let pivotTable = sheet.pivotTables.add("pivotTable", source, 1, 1, GC.Spread.Pivot.PivotTableLayoutType.outline, GC.Spread.Pivot.PivotTableThemes.medium8,option);
pivotTable.suspendLayout();
pivotTable.add("quantity", "Quantity", GC.Spread.Pivot.PivotTableFieldType.filterField);
pivotTable.add("price", "Price", GC.Spread.Pivot.PivotTableFieldType.filterField);
pivotTable.add("salesperson", "Salesperson", GC.Spread.Pivot.PivotTableFieldType.rowField);
pivotTable.add("car", "Cars", GC.Spread.Pivot.PivotTableFieldType.rowField);
let groupInfo = { originFieldName: "date", dateGroups: [{ by: GC.Pivot.DateGroupType.quarters }] };
pivotTable.group(groupInfo);
pivotTable.add("季度 (date)", "季度 (date)",GC.Spread.Pivot.PivotTableFieldType.columnField);
pivotTable.add("total", "Totals", GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
let style = new GC.Spread.Sheets.Style();
style.formatter = "$ #,##0";
pivotTable.setStyle({dataOnly: true}, style);
pivotTable.resumeLayout();
pivotTable.autoFitColumn();
return pivotTable;
}
function bindEvent(pivotTable){
document.getElementById("set-option").addEventListener("click", function(event){
pivotTable.suspendLayout();
let radioOption = document.getElementsByClassName("select-option");
let option = pivotTable.options, item;
for (let i = 0; i < radioOption.length; i++) {
item = radioOption[i];
option[item.value] = item.checked;
}
let grandTotalPosition = document.getElementById("grandTotalPosition");
option["grandTotalPosition"] = GC.Spread.Pivot.GrandTotalPosition[grandTotalPosition.options[grandTotalPosition.selectedIndex].text];
let subtotalsPosition = document.getElementById("subtotalsPosition");
option["subTotalsPosition"] = GC.Spread.Pivot.SubtotalsPosition[subtotalsPosition.options[subtotalsPosition.selectedIndex].text];
let displayFields = document.getElementById("displayFieldsInPageFilterArea");
option["displayFieldsInPageFilterArea"] = GC.Spread.Pivot.DisplayFields[displayFields.options[displayFields.selectedIndex].text];
let reportFilterFieldsPerColumn = document.getElementById("reportFilterFieldsPerColumn");
option["reportFilterFieldsPerColumn"] = +reportFilterFieldsPerColumn.value;
let missingCaption = document.getElementById("missingCaption");
if (!isNaN(parseFloat(missingCaption.value))) {
option["missingCaption"] = parseFloat(missingCaption.value);
} else {
option["missingCaption"] = missingCaption.value;
}
let rowLabelIndent = document.getElementById('rowLabelIndent');
if (!isNaN(parseFloat(rowLabelIndent.value))) {
option["rowLabelIndent"] = parseFloat(rowLabelIndent.value);
}
pivotTable.layoutType(+document.getElementById("pivotTableLayout").value);
pivotTable.resumeLayout();
});
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta name="spreadjs culture" content="zh-cn" />
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-shapes/dist/gc.spread.sheets.shapes.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-pivot-addon/dist/gc.spread.pivot.pivottables.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/data/pivot-data.js" type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-spreadsheets"></div>
<div id="container" class="options-container">
<div class="option-item">
<label><b>数据透视表选项</b></label>
</div>
<hr>
<div class="option-item">
<input type="checkbox" id="allowMultipleFiltersPerField" name="allowMultipleFiltersPerField"
value="allowMultipleFiltersPerField" class="select-option">
<label for="allowMultipleFiltersPerField">允许每个字段使用多个筛选器</label>
</div>
<div class="option-item">
<input type="checkbox" id="insertBlankLineAfterEachItem" name="insertBlankLineAfterEachItem"
value="insertBlankLineAfterEachItem" class="select-option">
<label for="insertBlankLineAfterEachItem">在每个项目后插入空行</label>
</div>
<div class="option-item">
<input type="checkbox" id="fillDownLabels" name="fillDownLabels" value="fillDownLabels"
class="select-option">
<label for="fillDownLabels">向下填充标签</label>
</div>
<div class="option-item">
<input type="checkbox" id="bandRows" name="bandRows" value="bandRows" class="select-option" checked>
<label for="bandRows">行带区</label>
</div>
<div class="option-item">
<input type="checkbox" id="bandColumns" name="bandColumns" value="bandColumns" class="select-option"
checked>
<label for="bandColumns">列带区</label>
</div>
<div class="option-item">
<input type="checkbox" id="showRowHeader" name="showRowHeader" value="showRowHeader"
class="select-option" checked>
<label for="showRowHeader">显示行标题</label>
</div>
<div class="option-item">
<input type="checkbox" id="showColumnHeader" name="showColumnHeader" value="showColumnHeader"
class="select-option" checked>
<label for="showColumnHeader">显示列标题</label>
</div>
<div class="option-item">
<input type="checkbox" id="showDrill" name="showDrill" value="showDrill" class="select-option" checked>
<label for="showDrill">显示展开/折叠</label>
</div>
<div class="option-item">
<input type="checkbox" id="showFilter" name="showFilter" value="showFilter" class="select-option"
checked>
<label for="showFilter">显示筛选器</label>
</div>
<div class="option-item">
<input type="checkbox" id="showMissing" name="showMissing" value="showMissing" class="select-option"
checked>
<label for="showMissing">显示缺失值</label>
</div>
<div class="option-item">
<input type="checkbox" id="showToolTip" name="showToolTip" value="showToolTip" class="select-option"
checked>
<label for="showToolTip">显示工具提示</label>
</div>
<div class="option-item">
<input type="checkbox" id="mergeItem" name="mergeItem" value="mergeItem" class="select-option">
<label for="mergeItem">合并项目</label>
</div>
<div class="option-item">
<input type="checkbox" id="showHeaders" name="showHeaders" value="showHeaders" class="select-option"
checked>
<label for="showHeaders">显示标题</label>
</div>
<hr>
<div>
<div class="select-option-class">总计位置:</div>
<select name="" id="grandTotalPosition" class="grandTotalPosition select-option-select">
<option value="both">两者</option>
<option value="none">无</option>
<option value="row">行</option>
<option value="col">列</option>
</select>
</div>
<div>
<div class="select-option-class">分类汇总位置:</div>
<select name="" id="subtotalsPosition" class="subtotalsPosition select-option-select">
<option value="bottom">底部</option>
<option value="none">无</option>
<option value="top">顶部</option>
</select>
</div>
<div>
<div class="select-option-class">页字段区域显示字段:</div>
<select name="" id="displayFieldsInPageFilterArea"
class="displayFieldsInPageFilterArea select-option-select">
<option value="overThenDown">先横向后纵向</option>
<option value="downThenOver">先纵向后横向</option>
</select>
</div>
<div>
<div class="select-option-class">数据透视表布局:</div>
<select id="pivotTableLayout" class="pivotTableLayout select-option-select">
<option value=0>压缩</option>
<option value=1 selected>大纲</option>
<option value=2>表格</option>
</select>
</div>
<div>
<div class="select-option-class">内容区域空值显示为:</div>
<input type="text" name="" id="missingCaption" class="missingCaption select-option-select" />
</div>
<div>
<div class="select-option-class">压缩布局行标签缩进:</div>
<input type="number" name="" id="rowLabelIndent" class="rowLabelIndent select-option-select" />
</div>
<div>
<label for="reportFilterFieldsPerColumn">每列报表筛选字段数:</label>
<input type="number" value="1" id="reportFilterFieldsPerColumn" min="1">
</div>
<input type="button" value="应用" class="set-option" id="set-option">
</div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 300px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 300px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
.set-option {
display: block;
margin-top: 20px;
width: 250px;
}
#reportFilterFieldsPerColumn {
width: 28px;
}
.select-option-class{
display: block;
margin-top: 20px;
margin-bottom: 10px
}
.select-option-select{
width: 250px;
display: block;
margin-bottom: 20px;
}
.option-item{
height: 20px;
margin-bottom: 10px;
}