概述
本 Demo 展示了迷你图的分组、类型切换和日期轴控制功能。通过交互界面，用户可以选择多个迷你图进行分组操作，动态切换迷你图类型（折线图、柱形图、盈亏图），以及控制日期轴的显示。
实现思路
初始化数据：创建数值数据和对应的日期轴数据
创建三种类型的迷你图：折线图、柱形图、盈亏图，每种类型都设置了不同的显示选项（如显示标记点、最高/最低点、坐标轴等）
实现分组功能：通过遍历选中的单元格，收集其中的迷你图，调用 groupSparkline 进行分组或使用 ungroupSparkline 取消分组
实现类型切换和日期轴控制：为下拉框和复选框添加事件监听，动态修改迷你图的属性
代码解析
创建带日期轴的迷你图
这段代码创建了一个带日期轴的折线迷你图。setSparkline 方法的参数依次为：单元格位置、数据范围、数据方向、迷你图类型、设置对象、日期轴范围、日期轴方向。SparklineSetting 用于配置迷你图的显示选项，如标记点、最高/最低点、坐标轴等。
迷你图分组
分组操作会遍历选中区域的所有单元格，收集其中的迷你图对象，然后调用 groupSparkline 方法进行分组。同一组中的迷你图将共享设置，修改其中一个会影响整组。
动态修改迷你图类型
通过 sparklineType() 方法可以获取或设置迷你图的类型，支持折线图、柱形图 和盈亏图 三种类型。
运行效果
表格中展示三种不同类型的迷你图，分别使用折线图、柱形图和盈亏图展示相同的数据
选择多个包含迷你图的单元格后点击"组合"按钮，迷你图会被分组，同组迷你图共享设置
点击"取消组合"按钮可以解除分组
在下拉框中选择不同的类型，选中单元格中的迷你图会立即切换类型
勾选或取消"显示日期轴"复选框，可以控制迷你图是否显示日期轴
API 参考
setSparkline 方法
row、col：单元格位置
dataRange：数据范围
dataOrientation：数据方向（vertical 或 horizontal）
sparklineType：迷你图类型
sparklineSetting：迷你图设置对象
dateAxisRange：可选，日期轴范围
dateAxisOrientation：可选，日期轴方向
groupSparkline 方法
sparklines：要分组的迷你图数组
返回：SparklineGroup 对象
SparklineSetting 类
用于配置迷你图的显示选项，常用的 options 属性包括：
showMarkers：是否显示数据标记
displayXAxis：是否显示 X 轴
showFirst、showLast、showHigh、showLow、showNegative：是否突出显示特定数据点
var spreadNS = GC.Spread.Sheets;
window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
initSpread(spread);
};
function initSpread(spread) {
var sheet = spread.getSheet(0);
sheet.suspendPaint();
sheet.options.allowCellOverflow = true;
var data = [1,-2,-1,6,4,-4,3,8];
var dateAxis = [new Date(2011, 0, 5),new Date(2011, 0, 1),new Date(2011, 1, 11),new Date(2011, 2, 1),
new Date(2011, 1, 1),new Date(2011, 1, 3),new Date(2011, 2, 6),new Date(2011, 1, 19)];
sheet.setValue(0, 0, "Series 1");
sheet.setValue(0, 1, "Series 2");
for(let i=0;i<8;i++)
{
sheet.setValue(i+1, 0,data[i]);
sheet.getCell(i+1, 1).value(dateAxis[i]).formatter("yyyy-mm-dd");
}
sheet.setColumnWidth(1,100);
sheet.setValue(10, 0, "*Data Range is A2-A9");
sheet.setValue(11, 0, "*Date axis range is B2-B9");
var dataRange = new spreadNS.Range(1, 0, 8, 1);
var dateAxisRange = new spreadNS.Range(1, 1, 8, 1);
sheet.getCell(13, 0).text("Sparkline with dateAxis:");
sheet.getCell(14, 0).text("(1) Line");
sheet.getCell(14, 3).text("(2)Column");
sheet.getCell(14, 6).text("(3)Winloss");
//line
sheet.addSpan(15, 0, 4, 3);
var setting = new spreadNS.Sparklines.SparklineSetting();
setting.options.showMarkers = true;
setting.options.displayXAxis = true;
setting.options.showFirst = true;
setting.options.showLast = true;
setting.options.showLow = true;
setting.options.showHigh = true;
setting.options.showNegative = true;
sheet.setSparkline(15, 0, dataRange
, spreadNS.Sparklines.DataOrientation.vertical
, spreadNS.Sparklines.SparklineType.line
, setting
, dateAxisRange
, spreadNS.Sparklines.DataOrientation.vertical
);
//column
sheet.addSpan(15, 3, 4, 3);
setting = new spreadNS.Sparklines.SparklineSetting();
setting.options.displayXAxis = true;
setting.options.showFirst = true;
setting.options.showLast = true;
setting.options.showLow = true;
setting.options.showHigh = true;
setting.options.showNegative = true;
sheet.setSparkline(15, 3, dataRange
, spreadNS.Sparklines.DataOrientation.vertical
, spreadNS.Sparklines.SparklineType.column
, setting
, dateAxisRange
, spreadNS.Sparklines.DataOrientation.vertical
);
//winloss
sheet.addSpan(15, 6, 4, 3);
setting = new spreadNS.Sparklines.SparklineSetting();
setting.options.displayXAxis = true;
setting.options.showNegative = true;
sheet.setSparkline(15, 6, dataRange
, spreadNS.Sparklines.DataOrientation.vertical
, spreadNS.Sparklines.SparklineType.winloss
, setting
, dateAxisRange
, spreadNS.Sparklines.DataOrientation.vertical
);
sheet.bind(spreadNS.Events.SelectionChanged, selectionChangedCallback);
sheet.resumePaint();
function selectionChangedCallback() {
var sheet = spread.getActiveSheet();
var sparkline = sheet.getSparkline(sheet.getActiveRowIndex(), sheet.getActiveColumnIndex());
if (sparkline) {
updateSetting(sparkline);
} else {
initSetting();
}
}
function updateSetting(sparkline) {
var type = sparkline.sparklineType(), displayDateAxis = sparkline.displayDateAxis();
var sparklinetype = _getElementById("sparklinetype");
_selectOption(sparklinetype, type + "");
_getElementById("displayDateAxis").setAttribute("checked", !!displayDateAxis);
}
function initSetting() {
var sparklinetype = _getElementById("sparklinetype");
_selectOption(sparklinetype, '0');
_getElementById("displayDateAxis").setAttribute("checked", false);
}
function getActualRange(range, maxRowCount, maxColCount) {
var row = range.row < 0 ? 0 : range.row;
var col = range.col < 0 ? 0 : range.col;
var rowCount = range.rowCount < 0 ? maxRowCount : range.rowCount;
var colCount = range.colCount < 0 ? maxColCount : range.colCount;
return new spreadNS.Range(row, col, rowCount, colCount);
}
_getElementById("btnGroupSparkline").addEventListener('click',function () {
var sheet = spread.getActiveSheet();
sheet.suspendPaint();
var sels = sheet.getSelections();
var i = 0;
var sparklines = [];
for (var n = 0; n < sels.length; n++) {
if (sels) {
var sel = getActualRange(sels[n], sheet.getRowCount(), sheet.getColumnCount());
var rowCount = sel.rowCount;
var colCount = sel.colCount;
for (var i = 0; i < rowCount; i++) {
for (var j = 0; j < colCount; j++) {
var sparkline = sheet.getSparkline(sel.row + i, sel.col + j);
if (sparkline != null) {
sparklines.push(sparkline);
}
}
}
sheet.groupSparkline(sparklines);
}
}
sheet.resumePaint();
});
_getElementById("btnUnGroupSparkline").addEventListener('click',function () {
var sheet = spread.getActiveSheet();
sheet.suspendPaint();
var sels = sheet.getSelections();
var sparkline;
for (var n = 0; n < sels.length; n++) {
if (sels) {
var sel = getActualRange(sels[0], sheet.getRowCount(), sheet.getColumnCount());
var rowCount = sel.rowCount;
var colCount = sel.colCount;
for (var i = 0; i < rowCount; i++) {
for (var j = 0; j < colCount; j++) {
sparkline = sheet.getSparkline(sel.row + i, sel.col + j);
if (sparkline != null) {
sheet.ungroupSparkline(sparkline.group());
}
}
}
}
}
sheet.resumePaint();
});
_getElementById("sparklinetype").addEventListener('change',function () {
var sheet = spread.getActiveSheet();
sheet.suspendPaint();
var sels = sheet.getSelections();
var sparkline;
for (var n = 0; n < sels.length; n++) {
if (sels) {
var sel = getActualRange(sels[0], sheet.getRowCount(), sheet.getColumnCount());
var rowCount = sel.rowCount;
var colCount = sel.colCount;
for (var i = 0; i < rowCount; i++) {
for (var j = 0; j < colCount; j++) {
sparkline = sheet.getSparkline(sel.row + i, sel.col + j);
if (sparkline != null) {
sparkline.sparklineType(parseInt(this.value));
}
}
}
}
}
sheet.resumePaint();
});
_getElementById("displayDateAxis").addEventListener('change',function () {
var sheet = spread.getActiveSheet();
sheet.suspendPaint();
var sels = sheet.getSelections();
var sparkline;
for (var n = 0; n < sels.length; n++) {
if (sels) {
var sel = getActualRange(sels[0], sheet.getRowCount(), sheet.getColumnCount());
var rowCount = sel.rowCount;
var colCount = sel.colCount;
for (var i = 0; i < rowCount; i++) {
for (var j = 0; j < colCount; j++) {
sparkline = sheet.getSparkline(sel.row + i, sel.col + j);
if (sparkline != null) {
sparkline.displayDateAxis(this.checked);
}
}
}
}
}
sheet.resumePaint();
});
};
function _getElementById(id){
return document.getElementById(id);
}
function _selectOption(select, value) {
for (var i = 0; i < select.length; i++) {
var op = select.options[i];
if (op.value === value) {
op.selected = true;
} else {
op.selected = false;
}
}
}
<!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-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="options-container">
<div class="option-group">
<label><b>组合和取消组合迷你图：</b></label>
</div>
<hr>
<div class="option-group">
<label>您可以选择多个迷你图并将它们组合（或取消组合）。</label>
</div>
<div class="option-group">
<label>组合迷你图</label>
</div>
<div class="option-group">
<input type="button" value="组合" id="btnGroupSparkline">
</div>
<div class="option-group">
<label>取消组合迷你图</label>
</div>
<div class="option-group">
<input id='btnUnGroupSparkline' type='button' value='取消组合' />
</div>
<br>
<div class="option-group">
<label>*同一组中的迷你图具有相同的设置。
如果您更改其中一个迷你图的设置，该更改将反映在该组中的所有迷你图中。</label>
</div>
<div class="option-group">
<label><b>更改迷你图设置：</b></label>
</div>
<hr>
<div class="option-group">
<label for="sparklinetype">类型：</label>
<select id="sparklinetype">
<option value="0">折线图</option>
<option value="1">柱形图</option>
<option value="2">盈亏图</option>
</select>
</div>
<div class="option-group">
<input type="checkbox" id="displayDateAxis" checked />
<label for="displayDateAxis">显示日期轴</label>
</div>
</div>
</div>
</body>
</html>
.sample {
position: relative;
height: 100%;
overflow: auto;
}
.sample::after {
display: block;
content: "";
clear: both;
}
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
.option-row {
font-size: 14px;
padding: 5px;
margin-top: 10px;
}
.option-group {
margin-bottom: 12px;
}
input,
select {
padding: 4px 6px;
box-sizing: border-box;
}
p{
padding:2px 10px;
background-color:#F4F8EB;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
