使用 SpreadJS 实现 JavaScript 中导入和导出Excel文件

时间 2021-08-14

标签 javascript php css html 前端 java jquery c++ web ajax 栏目 JavaScript 繁體版

原文原文链接

JavaScript是一个涵盖多种框架、直译式、能够轻松自定义客户端的脚本语言，在 Web 应用程序中，更加易于编码和维护。而Excel 做为一款深受用户喜好的电子表格工具，借助其直观的界面、出色的计算性能和图表工具，已经成为数据统计领域不可或缺的软件之一。javascript

若是有一款产品，可以将两者完美融合，将在前端表格数据处理、数据填报、数据可视化、在线文档等领域大放异彩。SpreadJS，正是这样一款功能布局与Excel高度相似，无需大量代码开发和测试便可实现数据展现、前端 Excel 导入导出、图表面板、数据绑定等业务场景的纯前端表格控件。php

使用JavaScript实现 Excel 的导入和导出

经过纯JavaScript，您彻底能够实现导入和导出Excel文件功能，并为最终用户提供与这些文件进行I/O交互的界面。在本篇教程中，我将向您展现如何借助SpreadJS，在JavaScript中轻松实现导入和导出Excel文件的操做，以及将SpreadJS组件添加到HTML页面是多么的容易。css

工欲善其事，必先利其器

请下载SpreadJS 纯前端表格控件，以便同步体验

设置JavaScript的电子表格项目

建立一个新的HTML页面并添加对SpreadJS下载包中Spread.Sheets脚本和CSS文件的引用：html

<!DOCTYPE html>  
<html>  
<head>  
    <title>SpreadJS ExcelIO</title>  

    <script src="http://code.jquery.com/jquery-2.1.3.min.js" type="text/javascript"></script>  
    <script src="http://code.jquery.com/ui/1.11.4/jquery-ui.min.js" type="text/javascript"></script>  

    <link href="http://cdn.grapecity.com/spreadjs/hosted/css/gc.spread.sheets.excel2013white.10.1.0.css" rel="stylesheet" type="text/css" />  
    <script type="text/javascript" src="http://cdn.grapecity.com/spreadjs/hosted/scripts/gc.spread.sheets.all.10.1.0.min.js"></script>  
    <script type="text/javascript" src="http://cdn.grapecity.com/spreadjs/hosted/scripts/interop/gc.spread.excelio.10.1.0.min.js"></script>  

</head>  
<body>  
    <div id="ss" style="height:600px ; width :100%; "></div>  
</body>  
</html>

而后在初始化Spread.Sheets组件的页面中添加一个脚本，并使用div元素来包含它（由于SpreadJS电子表格组件使用了Canvas 绘制界面，因此这是初始化组件所必需的一步）：前端

<script type="text/javascript">  
    $(document).ready(function () {  
        var workbook = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));  
    });  
</script>  
</head>  
<body>  
<div id="ss" style="height:600px ; width :100%; "></div>  
</body>

添加Excel导入代码

咱们须要建立一个客户端ExcelIO组件的实例，并用它来实际打开 Excel 文件：java

var excelIO = new GC.Spread.Excel.IO();

而后咱们须要添加一个导入文件的函数。在此示例中，咱们导入本地文件，但您能够对服务器上的文件执行相同的操做。若是要从服务器端导入文件，则须要引用该位置。如下是输入元素的示例，用户能够在其中输入文件的位置：jquery

<input type="text" id="importUrl" value="http://www.testwebsite.com/files/TestExcel.xlsx" style="width:300px" />

完成上述步骤后，您能够直接在脚本代码中访问该值：c++

var excelUrl = $("#importUrl").val();

如下导入函数的代码只使用本地文件做为“excelUrl”变量：web

function ImportFile() {  
    var excelUrl = "./test.xlsx";  

    var oReq = new XMLHttpRequest();  
    oReq.open('get', excelUrl, true);  
    oReq.responseType = 'blob';  
    oReq.onload = function () {  
        var blob = oReq.response;  
        excelIO.open(blob, LoadSpread, function (message) {  
            console.log(message);  
        });  
    };  
    oReq.send(null);  
}  
function LoadSpread(json) {  
    jsonData = json;  
    workbook.fromJSON(json);  

    workbook.setActiveSheet("Revenues (Sales)");  
}

不管您是在服务器上仍是在本地引用文件，都须要在 $（document）.ready函数内的脚本中添加如下内容：ajax

$(document).ready(function () {  
    $.support.cors = true;  
    workbook = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));  
    //...  
});

将数据添加到Excel文件

在本教程中，咱们以导入一个名为 “Profit loss statement” 的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：
sheet.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方法并指定：
• 迷你图的位置
• 数据的位置
• 迷你图的方向
• 迷你图的类型
• 咱们建立的设置

sheet.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加载文件时，在任何浏览器中均可以打开。

添加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) {  
            alert(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中打开的模板除了以前导入的内容外，还增长了新的“收入行”。

经过这个示例，向您展现了如何使用SpreadJS 纯前端表格控件，将Excel数据导入到网页中，在网页进行数据更新后，又经过简单的几行JavaScript代码将它们从新导出成Excel 文件。您能够在SpreadJS产品官网，查看本篇教程并下载Demo示例。

SpreadJS – ExcelIO示例

本篇教程，仅展现了SpreadJS 的部分功能，即前端导入、导出Excel文件，更多的功能如数据分析、打印、导出PDF、自定义公式函数等，请前往SpreadJS产品官网了解更多。