迷你图配置 | 功能示例 | SpreadJS 在线示例

概述本 Demo 展示了如何创建和配置迷你图，包括三种类型（折线、柱形、盈亏）的迷你图创建、数据标记的显示控制、颜色样式设置以及运行时动态修改迷你图配置。实现思路创建数据源：Series 1 包含数值数据，Series 2 包含日期轴数据创建三种类型的迷你图（折线、柱形、盈亏），使用相同的数据范围和日期轴为每种迷你图配置不同的显示选项和颜色绑定选择变化事件，当用户点击迷你图单元格时显示当前配置提供 UI 界面允许用户修改迷你图的类型、显示选项和颜色代码解析创建数据源 Demo 准备了数据值和对应的日期轴数据，通过 Range 对象指定数据范围。创建折线迷你图创建 SparklineSetting 对象并配置各种显示选项，然后使用 setSparkline 方法创建折线迷你图，指定数据范围、数据方向、迷你图类型、配置对象和日期轴范围。动态修改迷你图配置通过 getSparkline 获取选中单元格的迷你图对象，然后修改其 setting 和 sparklineType 属性来更新迷你图。运行效果页面加载后显示三个迷你图：折线图、柱形图和盈亏图，分别使用相同的数据但不同的显示效果点击任意迷你图单元格，右侧面板会显示该迷你图的当前配置可以在右侧面板中修改迷你图类型（折线/柱形/盈亏）、显示选项（第一个/最后/最高/最低/负值标记）和颜色点击「更改设置」按钮应用修改，迷你图会实时更新显示 API 参考 setSparkline 方法为指定单元格设置迷你图。 row、col：迷你图所在单元格位置 dataRange：数据范围（Range 对象） dataOrientation：数据方向（vertical 或 horizontal） sparklineType：迷你图类型（line、column、winloss） sparklineSetting：迷你图配置对象 dateAxisRange：可选，日期轴范围 dateAxisOrientation：可选，日期轴方向 SparklineSetting 配置

window.onload = function () {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'));
initSpread(spread);
};
function initSpread(spread) {
var spreadNS = GC.Spread.Sheets;
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) {
getSparklineSettings(sparkline);
_getElementById('btnChangeSetting').disabled = false;
} else {
initSparklineSettings();
_getElementById('btnChangeSetting').disabled = true;
}
}
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);
}
function findSparkLine(sheet, range) {
var row = range.row,
col = range.col,
rowCount = range.rowCount,
colCount = range.colCount;
for (var i = 0; i < rowCount; i++) {
for (var j = 0; j < colCount; j++) {
var sparkline = sheet.getSparkline(row + i, col + j);
if (sparkline != null) {
return sparkline;
}
}
}
return null;
}
_getElementById('btnChangeSetting').addEventListener('click', function () {
var sheet = spread.getActiveSheet();
sheet.suspendPaint();
var sels = sheet.getSelections();
var setting = new spreadNS.Sparklines.SparklineSetting();
var sparklinetype = _getElementById("sparklinetype");
var index = sparklinetype.selectedIndex;
var sparklineType = parseInt(sparklinetype.options[index].value, 10);
if (sels && sels.length > 0) {
var sel = getActualRange(sels[0], sheet.getRowCount(), sheet.getColumnCount());
var sparkline = findSparkLine(sheet, sel);
if (sparkline != null) {
sparkline.setting(buildSparklineSettings(setting));
sparkline.sparklineType(sparklineType);
}
}
sheet.resumePaint();
});
function initSparklineSettings() {
var sparklinetype = _getElementById("sparklinetype");
_selectOption(sparklinetype, '0');
_getElementById('firstMarkerColor').setAttribute('value', '(none)');
_getElementById('highMarkerColor').setAttribute('value', 'Blue');
_getElementById('lastMarkerColor').setAttribute('value', '(none)');
_getElementById('lowMarkerColor').setAttribute('value', 'Blue');
_getElementById('negativeMarkerColor').setAttribute('value', 'Brown');
_getElementById('markersColor').setAttribute('value', '(none)');
_getElementById('AxisColor').setAttribute('value', 'Black');
_getElementById('SeriesColor').setAttribute('value', '(none)');
_getElementById('showFirst').checked = false;
_getElementById('showHigh').checked = false;
_getElementById('showLast').checked = false;
_getElementById('showLow').checked = false;
_getElementById('showNegative').checked = false;
_getElementById('showMarkers').checked = false;
_getElementById('displayXAxis').checked = true;
}
function getSparklineSettings(sparkline) {
var setting = sparkline.setting();
var sparklinetype = _getElementById("sparklinetype");
_selectOption(sparklinetype, sparkline.sparklineType() + "");
_getElementById('firstMarkerColor').setAttribute('value', setting.options.firstMarkerColor);
_getElementById('highMarkerColor').setAttribute('value', setting.options.highMarkerColor);
_getElementById('lastMarkerColor').setAttribute('value', setting.options.lastMarkerColor);
_getElementById('lowMarkerColor').setAttribute('value', setting.options.lowMarkerColor);
_getElementById('negativeMarkerColor').setAttribute('value', setting.options.negativeColor);
_getElementById('markersColor').setAttribute('value', setting.options.markersColor);
_getElementById('AxisColor').setAttribute('value', setting.options.axisColor);
_getElementById('SeriesColor').setAttribute('value', setting.options.seriesColor);
_getElementById('showFirst').checked = setting.options.showFirst;
_getElementById('showHigh').checked = setting.options.showHigh;
_getElementById('showLast').checked = setting.options.showLast;
_getElementById('showLow').checked = setting.options.showLow;
_getElementById('showNegative').checked = setting.options.showNegative;
_getElementById('showMarkers').checked = setting.options.showMarkers;
_getElementById('displayXAxis').checked = setting.options.displayXAxis;
}
function buildSparklineSettings(setting) {
if (setting == null) setting = new spreadNS.Sparklines.SparklineSetting();
var firstMarkerColor = _getElementById('firstMarkerColor');
if (firstMarkerColor.value != '(none)') setting.options.firstMarkerColor = firstMarkerColor.value;
var highMarkerColor = _getElementById('highMarkerColor');
if (highMarkerColor.value != '(none)') setting.options.highMarkerColor = highMarkerColor.value;
var lastMarkerColor = _getElementById('lastMarkerColor');
if (lastMarkerColor.value != '(none)') setting.options.lastMarkerColor = lastMarkerColor.value;
var lowMarkerColor = _getElementById('lowMarkerColor');
if (lowMarkerColor.value != '(none)') setting.options.lowMarkerColor = lowMarkerColor.value;
var negativeMarkerColor = _getElementById('negativeMarkerColor');
if (negativeMarkerColor.value != '(none)') setting.options.negativeColor = negativeMarkerColor.value;
var markersColor = _getElementById('markersColor');
if (markersColor.value != '(none)') setting.options.markersColor = markersColor.value;
var AxisColor = _getElementById('AxisColor');
if (AxisColor.value != '(none)') setting.options.axisColor = AxisColor.value;
var SeriesColor = _getElementById('SeriesColor');
if (SeriesColor.value != '(none)') setting.options.seriesColor = SeriesColor.value;
setting.options.showFirst = _getElementById('showFirst').checked;
setting.options.showHigh = _getElementById('showHigh').checked;
setting.options.showLast = _getElementById('showLast').checked;
setting.options.showLow = _getElementById('showLow').checked;
setting.options.showNegative = _getElementById('showNegative').checked;
setting.options.showMarkers = _getElementById('showMarkers').checked;
setting.options.displayXAxis = _getElementById('displayXAxis').checked;
return setting;
}
}
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-row">
<label>*请在电子表格中选择一个迷你图，然后更改其属性</label>
</div>
<div class="option-row">
<div class="option">
<input id='btnChangeSetting' type='button' value='更改设置' />
</div>
</div>
<div class="option-row">
<div class="option">
<input id='showFirst' type='checkbox' />
<label for="showFirst">显示第一个标记</label>
</div>
<div class="option">
<input id='showHigh' type='checkbox' />
<label for="showHigh">显示最高值标记</label>
</div>
<div class="option">
<input id='showLast' type='checkbox' />
<label for="showLast">显示最后一个标记</label>
</div>
<div class="option">
<input id='showLow' type='checkbox' />
<label for="showLow">显示最低值标记</label>
</div>
<div class="option">
<input id='showNegative' type='checkbox' />
<label for="showNegative">显示负值标记</label>
</div>
<div class="option">
<input id='showMarkers' type='checkbox' />
<label for="showMarkers">显示所有标记</label>
</div>
<div class="option">
<input id="displayXAxis" type="checkbox" />
<label for="displayXAxis">显示X轴</label>
</div>
</div>
<div class="option-row">
<div class="option">
<label for="firstMarkerColor" class="block">第一个标记颜色</label>
<input id='firstMarkerColor' class="control" value="(无)" />
</div>
<div class="option">
<label for="sparklinetype" class="block">类型：</label>
<select id="sparklinetype" class="control">
<option value="0">折线</option>
<option value="1">柱形</option>
<option value="2">盈亏</option>
</select>
</div>
<div class="option">
<label for="highMarkerColor" class="block">最高值标记颜色</label>
<input id='highMarkerColor' class="control" value="蓝色" />
</div>
<div class="option">
<label for="lastMarkerColor" class="block">最后一个标记颜色</label>
<input id='lastMarkerColor' class="control" value="(无)" />
</div>
<div class="option">
<label for="lowMarkerColor" class="block">最低值标记颜色</label>
<input id='lowMarkerColor' class="control" value="蓝色" />
</div>
<div class="option">
<label for="negativeMarkerColor" class="block">负值标记颜色</label>
<input id='negativeMarkerColor' class="control" value="棕色" />
</div>
<div class="option">
<label for="markersColor" class="block">所有标记颜色</label>
<input id='markersColor' class="control" value="(无)" />
</div>
<div class="option">
<label for="AxisColor" class="block">坐标轴颜色</label>
<input id='AxisColor' class="control" value="黑色" />
</div>
<div class="option">
<label for="SeriesColor" class="block">系列颜色</label>
<input id='SeriesColor' class="control" value="(无)" />
</div>
</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 {
padding-bottom: 6px;
}
.block {
display: block;
padding: 6px 0;
}
.control {
padding: 4px 8px;
box-sizing: border-box;
width: 100%;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}