当前位置：首页 > news >正文

SpreadJS 迷你图：数据趋势可视化的利器

news 2025/6/30 1:28:32

引言

在数据处理和分析领域，直观地展示数据趋势对于理解数据和做出决策至关重要。迷你图作为一种简洁而有效的数据可视化方式，在显示数据趋势方面发挥着重要作用，尤其在与他人共享数据时，能够快速传达关键信息。SpreadJS 作为一款强大的电子表格组件，对迷你图功能提供了丰富的支持。本文将详细介绍 SpreadJS 迷你图的特点、优势、创建方式以及与 GcExcel 的兼容情况。

迷你图的概述与作用

迷你图是单个工作表单元格内的微型图表，它在显示数据趋势时非常有用。通过迷你图，可以直观地表示和显示数据趋势，用不同颜色吸引对某些内容（如季节性增加或降低或经济周期）的注意，并突出显示最大和最小值。当我们需要与他人共享数据时，迷你图能够以简洁的方式传达数据的关键趋势，帮助他人快速理解数据背后的含义。

SpreadJS 对迷你图的支持

SpreadJS 充分认识到迷你图在数据可视化中的重要性，为用户提供了丰富的迷你图功能。它支持多种类型的迷你图，能够满足不同场景下的数据趋势展示需求。用户可以方便地在 SpreadJS 中创建迷你图，将复杂的数据以直观的方式呈现出来。

在 SpreadJS 中创建迷你图的方式

使用 setSparkline 方法：您可以使用 setSparkline 方法将迷你图类型设置为柱形、折线或盈亏类型，也可以使用特定类型的公式来创建 SpreadJS 中可用的不同迷你图。不过需要注意，使用公式创建的迷你图无法导出到 Excel 文件中。

setSparkline 方法的调用示例如下，之后调用 setSparkline () 方法并指定：

迷你图的位置
数据的位置
迷你图的方向
迷你图的类型
之前创建的设置

代码示例如下：

let sheet = spread.getActiveSheet(); 
sheet.setArray(0, 0, [1,2,3,4,3,2,3,5]);let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);```此外，还可以使用如下代码设置迷你图分组和取消分组：
```javascript
group.sparklineType = GC.Spread.Sheets.Sparklines.SparklineType.column;// 取消迷你图的分组
sheet.ungroupSparkline(group);```[1][1] [SpreadJS产品文档_葡萄城 SpreadJS 离线文档（Docs&API） - v18-20250416 - Page 1001 - 1500.pdf](https://lf9-appstore-sign.oceancloudapi.com/ocean-cloud-tos/FileBizType.BIZ_BOT_DATASET/406151306683948_1750323178937327824_NYuywwy2tN.pdf?lk3s=61a3dea3&x-expires=1753244510&x-signature=gP60MWYYY2J05ERK463oVANayxw%3D)[2] SpreadJS技术文章_如何使用 JavaScript 导入和导出 Excel.docx[3] GcExcel技术文章_如何使用 JavaScript 导入和导出 Excel.docx[4] [SpreadJS产品文档_葡萄城 SpreadJS 离线文档（Docs&API） - v18-20250416 - Page 6501 - 7000

自定义迷你图公式：在 SpreadJS 中，可以实现自己的逻辑，利用提供的数据集和设置来定义自定义迷你图公式，并使用 addSparklineEx 方法添加该自定义迷你图。使用以下步骤创建自定义迷你图：

以下示例代码展示了创建自定义迷你图的过程：

function Clock() { GC.Spread.Sheets.Sparklines.SparklineEx.call(this); 
} 
Clock.prototype = new GC.Spread.Sheets.Sparklines.SparklineEx(); 
Clock.prototype.createFunction = function () { var func = new GC.Spread.CalcEngine.Functions.Function('CLOCK', 1, 1); func.evaluate = function (args) { return args[0]; }; return func; 
}; 
Clock.prototype._drawCircle = function (context, centerX, centerY, radius) { context.beginPath(); context.arc(centerX, centerY, radius, 0, Math.PI * 2, true); context.stroke(); 
}; 
Clock.prototype._drawCenter = function (context, centerX, centerY, radius) { context.beginPath(); context.arc(centerX, centerY, radius, 0, Math.PI * 2, true); 
}

将迷你图呈现为图像：你可以通过将图片填充的 src 或 style.fill.src 属性绑定到迷你图公式，将迷你图呈现为图像。同样地，迷你图公式可以绑定到自选图形的 style.fill.src 属性上。此外，SpreadJS 允许在将迷你图绑定到 src 属性时，为迷你图添加渐变、纯色和其他填充效果。以下示例代码展示了如何添加一个矩形作为形状，并将其绑定到一个柱形迷你图 [2]。

下面的图片展示了垂直柱形迷你图的实际应用，它展示了不同城市一年中气温水平的变化趋势，有助于快速了解数据的高低点。
在这里插入图片描述