概述
本 Demo 展示了如何在 SpreadJS 中创建瀑布图，并演示了基础样式和自定义样式两种配置方式。瀑布图用于展示一系列正负值如何影响初始值，适用于财务分析、项目管理等场景。
实现思路
使用 fromJSON 加载预设的表格数据
在第一个工作表创建自定义样式的瀑布图，配置图表区域、数据标签、图例、标题等样式
在第二个工作表创建基础样式的瀑布图，仅设置标题和连接线
通过 formatOvers 方法为瀑布图的不同数据类型（增加、减少、总计）设置不同的颜色
代码解析
创建瀑布图
这行代码创建了一个瀑布图，使用 GC.Spread.Sheets.Charts.ChartType.waterfall 指定图表类型，数据范围为 "B2:C15"。
设置系列属性
这段代码获取图表系列并设置关键属性：
showConnectorLines：显示连接线，将每一列的末尾与下一列的开头连接
gapWidth：设置柱状图之间的间隙宽度（最大值 5，最小值 0）
subtotals：指定哪些数据点显示为总计（0 表示第一个点，13 表示最后一个点）
自定义颜色配置
formatOvers 方法用于设置瀑布图不同数据类型的样式。其中，键 0 表示增加值，键 1 表示减少值，键 2 表示总计值。
运行效果
第一个工作表显示自定义样式的瀑布图，包含数据标签、底部图例、彩色柱状图（绿色表示增加、橙色表示减少、蓝色表示总计）
第二个工作表显示基础样式的瀑布图，使用默认颜色和简化的配置
两个图表都显示了连接线，清晰地展示数据流向
API 参考
charts.add 方法
name：图表名称
chartType：图表类型，瀑布图使用 GC.Spread.Sheets.Charts.ChartType.waterfall
x、y：图表位置
width、height：图表尺寸
dataRange：数据范围
series.subtotals 属性
类型：number[]
说明：瀑布图设置为总计点索引数组（0 基索引）
默认值：空数组
formatOvers 方法
value：瀑布图特定数据点的集合样式
对于瀑布图，键 0 表示增加，1 表示减少，2 表示总计
window.onload = function () {
let spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {
sheetCount: 2
});
initSpread(spread);
};
function initSpread(spread) {
let sheets = spread.sheets;
spread.suspendPaint();
spread.fromJSON(data);
let customWaterfallChart = sheets[0].charts.add("customWaterfallChart", GC.Spread.Sheets.Charts.ChartType.waterfall, 400, 0, 700, 450, "B2:C15");
let baseWaterfallChart = sheets[1].charts.add("baseWaterfallChart", GC.Spread.Sheets.Charts.ChartType.waterfall, 400, 0, 700, 450, "B2:C15");
setCustomStyle(customWaterfallChart);
setBaseStyle(baseWaterfallChart);
spread.resumePaint();
}
function setCustomStyle(chart) {
let chartArea = chart.chartArea();
chartArea.fontSize = 14;
chart.chartArea(chartArea);
let dataLabels = chart.dataLabels();
dataLabels.showValue = true;
dataLabels.color = 'rgb(64,60,61)';
dataLabels.position = GC.Spread.Sheets.Charts.DataLabelPosition.center;
chart.dataLabels(dataLabels);
let legend = chart.legend();
legend.position = GC.Spread.Sheets.Charts.LegendPosition.bottom;
chart.legend(legend)
let title = chart.title();
title.text = "Monthly Income";
title.fontSize = 16;
chart.title(title);
let series = chart.series().get(0);
series.showConnectorLines = true;
series.gapWidth = 0.2;
series.subtotals = [0, 13];
chart.series().set(0, series);
chart.formatOvers({
0: {
backColor: "rgb(61,198,147)",
},
1: {
backColor: "rgb(225,128,99)",
},
2: {
backColor: "rgb(91,188,214)",
}
});
}
function setBaseStyle(chart) {
let title = chart.title();
title.text = "Monthly Income";
title.fontSize = 16;
chart.title(title);
let series = chart.series().get(0);
series.showConnectorLines = true;
series.subtotals = [13];
chart.series().set(0, series);
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="spreadjs culture" content="zh-cn" />
<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-charts/dist/gc.spread.sheets.charts.min.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="$DEMOROOT$/spread/source/data/waterfallData.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-tutorial"></div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
