概述
本 Demo 展示了如何自定义数据透视表面板的布局和区域可见性。通过界面上的复选框和下拉菜单，用户可以动态控制面板的布局类型（堆叠或流式），以及显示或隐藏字段区域、区域部分和视图列表三个区域。
实现思路
初始化工作簿，准备数据源表（包含销售数据的表格）
创建数据透视表，配置行字段、列字段和值字段
创建 PivotPanel 实例，并将其挂载到页面指定容器
绑定界面控件的事件处理，根据用户选择更新面板设置
通过枚举值的位运算组合多个区域的可见性
代码解析
创建数据透视表面板
创建 PivotPanel 实例时，需要提供面板名称、关联的数据透视表对象，以及 DOM 容器元素。
设置面板区域可见性
这段代码通过遍历复选框控件，计算选中的区域枚举值之和。每个区域对应一个枚举值：
GC.Spread.Pivot.PivotPanelSection.fields = 1（字段区域）
GC.Spread.Pivot.PivotPanelSection.area = 2（区域部分）
GC.Spread.Pivot.PivotPanelSection.viewList = 4（视图列表）
通过将选中的值相加，可以实现多个区域的组合显示。例如，显示所有三个区域时，值为 7（1+2+4）。布局类型通过下拉菜单选择，值为 0（堆叠）或 1（流式）。
运行效果
页面右侧显示数据透视表面板，包含字段区域、区域部分和视图列表三个区域
取消勾选某个区域的复选框，点击"应用"按钮后，对应区域将被隐藏
切换布局类型下拉菜单（堆叠/流式），点击"应用"按钮后，面板布局会立即更新
堆叠布局（默认）：三个区域垂直排列
流式布局：三个区域水平排列
API 参考
PivotPanel 构造函数
name：面板名称
pivotTable：关联的数据透视表对象
host：DOM 容器元素
sectionVisibility 方法
value：可见区域的枚举值组合（通过位运算）
返回值：当前的可见性设置（数字）
可用枚举：GC.Spread.Pivot.PivotPanelSection.fields（1）、area（2）、viewList（4）
panelLayout 方法
value：布局类型枚举
返回值：当前的布局类型
可用枚举：GC.Spread.Pivot.PivotPanelLayoutType.stack（0，默认）、flow（1）
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 2 });
initSpread(spread);
var pivotLayoutSheet = spread.getSheet(0);
var panel = initPivotTable(pivotLayoutSheet);
bindEvent(panel);
};
function initSpread(spread) {
spread.suspendPaint();
let sheet = spread.getSheet(1);
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");
sheet.setArray(0, 0, pivotSales);
let table = sheet.tables.add('tableSales', 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"]);
let sheet0 = spread.getSheet(0);
sheet0.name("PivotLayout");
spread.resumePaint();
}
function initPivotTable(sheet) {
let myPivotTable = sheet.pivotTables.add("myPivotTable", "tableSales", 1, 1, GC.Spread.Pivot.PivotTableLayoutType.outline, GC.Spread.Pivot.PivotTableThemes.light8);
myPivotTable.suspendLayout();
myPivotTable.options.showRowHeader = true;
myPivotTable.options.showColumnHeader = true;
myPivotTable.add("salesperson", "Salesperson", GC.Spread.Pivot.PivotTableFieldType.rowField);
myPivotTable.add("car", "Cars", GC.Spread.Pivot.PivotTableFieldType.rowField);
let groupInfo = { originFieldName: "date", dateGroups: [{ by: GC.Pivot.DateGroupType.quarters }] };
myPivotTable.group(groupInfo);
myPivotTable.add("季度 (date)", "季度 (date)",GC.Spread.Pivot.PivotTableFieldType.columnField);
myPivotTable.add("total", "Totals", GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
var panel = new GC.Spread.Pivot.PivotPanel("myPivotPanel", myPivotTable, document.getElementById("panel"));
myPivotTable.resumeLayout();
myPivotTable.autoFitColumn();
return panel;
}
function _getElementById(id) {
return document.getElementById(id);
}
function bindEvent(panel){
_getElementById("set-option").addEventListener("click", function(event){
let radioOption = document.getElementsByClassName("select-option");
let result = 0, item;
for (let i = 0; i < radioOption.length; i++) {
item = radioOption[i];
if (item.checked) {
result += parseInt(item.value, 10);
}
}
panel.sectionVisibility(result);
let layoutType = _getElementById("layoutType");
panel.panelLayout(parseInt(layoutType.selectedOptions[0].value));
});
}
<!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/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="$DEMOROOT$/spread/source/js/license.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 class="sample-panel">
<div id="panel"></div>
</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="showFields" name="showFields" value="1" class="select-option" checked>
<label for="showFields">显示字段区域</label>
</div>
<div class="option-item">
<input type="checkbox" id="showArea" name="showArea" value="2" class="select-option" checked>
<label for="showArea">显示区域部分</label>
</div>
<div class="option-item">
<input type="checkbox" id="showViewList" name="showViewList" value="4" class="select-option" checked>
<label for="showViewList">显示视图列表</label>
</div>
<div>
<div class="select-option-class">布局类型：</div>
<select name="" id="layoutType" class="select-option-select">
<option value="0" selected>堆叠</option>
<option value="1">流式</option>
</select>
</div>
<input type="button" value="应用" class="set-option" id="set-option">
</div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
}
.sample-spreadsheets {
width: calc(100% - 600px);
height: 100%;
overflow: hidden;
display: inline-block;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
overflow: hidden;
}
.sample-panel {
width: 292px;
padding: 1px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
display: inline-block;
}
.gc-panel {
padding: 10px;
background-color: rgb(230, 230, 230);
}
#panel {
right: 0;
width: 292px;
height: 100%;
top: 0;
}
#app {
height: 100%;
}
.options-container {
width: 292px;
padding: 1px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
display: inline-block;
}
.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;
}
