使用SpreadJS纯前端表格控件能将JavaScript、Excel完美融合,无需大量代码开发和测试即可实现数据展示、前端Excel导入导出、图表面板、数据绑定等业务场景。本教程详细讲解了这一功能的使用方法。
本篇教程将向您展示如何借助SpreadJS在JavaScript中轻松实现导入和导出Excel文件的操作,以及将SpreadJS组件添加到HTML页面是多么的容易。(由于篇幅过长,本教程分为上、下两篇,有关本教程更多内容,请点击前往查阅>>>)
将数据添加到Excel文件
在本教程中,我们以导入一个名为“Profit loss statement”的Excel模板为例。

△ Excel模板
现在我们可以使用Spread.Sheets脚本在此文件中添加另一个收入行。让我们在页面上添加一个按钮来执行此操作:
<button id="addRevenue">Add Revenue</button>
我们可以为该按钮的click事件绑定一个函数,用以执行添加行并复制上一行的样式。要复制样式,我们需要使用copyTo函数并传入:
-
原点和目标行和列索引;
-
行数和列数;
-
样式的CopyToOptions值。
document.getElementById("addRevenue").onclick = function () { var sheet = workbook.getActiveSheet(); sheet.addRows(11, 1); sheet.copyTo(10, 1, 11, 1, 1, 29, GC.Spread.Sheets.CopyToOptions.style); }
用于添加数据和Sparkline的所有以下脚本代码都将包含在此按钮单击事件处理程序中。对于大多数数据,我们可以使用setValue函数。这允许我们通过传入行索引、列索引和值在Spread中的工作表上设置值:
sheet.setValue(11, 1, "Revenue 8"); for (var c = 3; c < 15; c++) { sheet.setValue(11, c, Math.floor(Math.random() * 200) + 10); }
在P列中设置SUM公式以匹配其他行,并为Q列设置百分比:
sheet.setFormula(11, 15, "=SUM([@[Jan]:[Dec]])") sheet.setValue(11, 16, 0.15);
最后,我们可以再次使用copyTo函数将前一行中的公式复制到R到AD列的新行,这次使用CopyToOptions.formula:
.copyTo(10, 17, 11, 17, 1, 13, GC.Spread.Sheets.CopyToOptions.formula);
添加迷你图
现在我们可以添加一个迷你图来匹配其他数据行。要做到这一点,我们需要提供一系列单元格来获取数据和一些迷你图设置。在这种情况下,我们可以指定:
-
我们刚刚添加数据的单元格范围;
-
设置使迷你图看起来像同一列中的其他迷你图。
var data = new GC.Spread.Sheets.Range(11, 3, 1, 12); var setting = new GC.Spread.Sheets.Sparklines.SparklineSetting(); setting.options.seriesColor = "Text 2"; setting.options.lineWeight = 1; setting.options.showLow = true; setting.options.showHigh = true; setting.options.lowMarkerColor = "Text 2"; setting.options.highMarkerColor = "Text 1";
然后,我们调用setSparkline方法并指定:
-
迷你图的位置
-
数据的位置
-
迷你图的方向
-
迷你图的类型
-
我们创建的设置
.setSparkline(11, 2, data, GC.Spread.Sheets.Sparklines.DataOrientation.horizontal, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
如果您现在尝试运行代码,可能会很慢,这是因为每次更改数据和添加样式时工作簿都会重新绘制。为了大幅提升速度和性能,Spread.Sheets提供了暂停绘画和计算服务的功能。让我们通过代码在添加行和数据之前暂停两者,并在完成数据加载后恢复:
workbook.suspendPaint(); workbook.suspendCalcService(); //... workbook.resumeCalcService(); workbook.resumePaint();
在添加该代码后,我们可以在Web浏览器中打开页面,并将Excel文件加载到Spread.Sheets中,并实现添加行的功能。
重要提示:请注意,Chrome出于安全目的不允许您打开本地文件,因此您需要使用Firefox等 络浏览器才能成功运行此代码。当然,如果您从 站URL加载文件时,在任何浏览器中都可以打开。

△ 用SpreadJS 在 页上实现的Excel模板
△ 带有用于添加收入行按钮的Excel模板
添加Excel导出代码
我们还可以实现:在 页中将带有添加行功能的Spread.Sheets 导出成Excel文件。在这里,我们使用Spread.Sheets中内置的客户端ExcelIO代码:
function ExportFile() { var fileName = $("#exportFileName").val(); if (fileName.substr(-5, 5) !== '.xlsx') { fileName += '.xlsx'; } var json = JSON.stringify(workbook.toJSON()); excelIO.save(json, function (blob) { saveAs(blob, fileName); }, function (e) { if (e.errorCode === 1) { ale rt(e.errorMessage); } }); }
该代码从exportFileName的输入元素中直接获取导出的文件名。我们可以定义它并让用户以这样的方式命名文件:
<input type="text" id="exportFileName" placeholder="Export file name" value="export.xlsx" />
在这里,我们继续为调用此函数添加一个按钮:
<button id="export">Export File</button> document.getElementById("export").onclick = function () { ExportFile(); }

在实现添加行功能后,可以使用“导出文件”的按钮导出Excel。请确保添加FileSaver外部库,以便用户将文件保存到他们本地:
<script src="https://cdnjs.cloudflare.com/ajax/libs/FileSaver.js/2014-11-29/FileSaver.min.js"></script>
成功导出文件后,您可以使用Excel打开它,这时你会发现,在Excel中打开的模板除了之前导入的内容外,还增加了新的“收入行”。

导出的文件在Excel中加载
通过这个示例,向您展示了如何使用SpreadJS纯前端表格控件,将Excel数据导入到 页中,在 页进行数据更新后,又通过简单的几行JavaScript代码将它们重新导出成Excel 文件。看完本教程后,您可以下载Demo示例体验以下。
-
SpreadJS—ExcelIO示例
想要获得 SpreadJS 更多资源或其他相关下载的朋友,请点击这里。
想要购买正版 SpreadJS 产品的朋友,请点击这里。

标签:
声明:本站部分文章及图片源自用户投稿,如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢!