JavaScript是一個涵蓋多種框架、直譯式、能夠輕鬆自定義客戶端的腳本語言,在 Web 應用程序中,更加易於編碼和維護。而Excel 做爲一款深受用戶喜好的電子表格工具,藉助其直觀的界面、出色的計算性能和圖表工具,已經成爲數據統計領域不可或缺的軟件之一。javascript
若是有一款產品,可以將兩者完美融合,將在前端表格數據處理、數據填報、數據可視化、在線文檔等領域大放異彩。SpreadJS,正是這樣一款功能佈局與Excel高度相似,無需大量代碼開發和測試便可實現數據展現、前端 Excel 導入導出、圖表面板、數據綁定等業務場景的純前端表格控件。php
經過純JavaScript,您徹底能夠實現導入和導出Excel文件功能,併爲最終用戶提供與這些文件進行I/O交互的界面。在本篇教程中,我將向您展現如何藉助SpreadJS,在JavaScript中輕鬆實現導入和導出Excel文件的操做,以及將SpreadJS組件添加到HTML頁面是多麼的容易。css
建立一個新的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>
咱們須要建立一個客戶端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")); //... });
在本教程中,咱們以導入一個名爲 「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加載文件時,在任何瀏覽器中均可以打開。
咱們還能夠實現:在網頁中將帶有添加行功能的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 的部分功能,即前端導入、導出Excel文件,更多的功能如數據分析、打印、導出PDF、自定義公式函數等,請前往SpreadJS產品官網瞭解更多。