JavaScript是一個涵蓋多種框架、直譯式、可以輕鬆自定義客戶端的腳本語言,在 Web 應用程式中,更加易於編碼和維護。而Excel 作為一款深受用戶喜愛的電子表格工具,藉助其直觀的界面、出色的計算性能和圖表工具,已經成為數據統計領域不可或缺的軟體之一。
如果有一款產品,能夠將二者完美融合,將在前端表格數據處理、數據填報、數據可視化、在線文檔等領域大放異彩。SpreadJS,正是這樣一款功能布局與Excel高度類似,無需大量代碼開發和測試即可實現數據展示、前端 Excel 導入導出、圖表面板、數據綁定等業務場景的純前端表格控制項。
訪問 SpreadJS 官網了解更多產品動態:https://www.grapecity.com.cn/developer/spreadjs
使用JavaScript實現 Excel 的導入和導出
通過純JavaScript,您完全可以實現導入和導出Excel文件功能,並為最終用戶提供與這些文件進行I/O交互的界面。在本篇教程中,我將向您展示如何藉助SpreadJS,在JavaScript中輕鬆實現導入和導出Excel文件的操作,以及將SpreadJS組件添加到HTML頁面是多麼的容易。
導入和編輯Excel文件後完成的頁面
工欲善其事,必先利其器
請下載SpreadJS 純前端表格控制項,以便同步體驗
設置JavaScript的電子表格項目
創建一個新的HTML頁面並添加對SpreadJS下載包中Spread.Sheets腳本和CSS文件的引用:
然後在初始化Spread.Sheets組件的頁面中添加一個腳本,並使用div元素來包含它(因為SpreadJS電子表格組件使用了Canvas 繪製界面,所以這是初始化組件所必需的一步):
添加Excel導入代碼
我們需要創建一個客戶端ExcelIO組件的實例,並用它來實際打開 Excel 文件:
var excelIO = new GC.Spread.Excel.IO();
然後我們需要添加一個導入文件的函數。在此示例中,我們導入本地文件,但您可以對伺服器上的文件執行相同的操作。如果要從伺服器端導入文件,則需要引用該位置。以下是輸入元素的示例,用戶可以在其中輸入文件的位置:
<input type="text" id="importUrl"
value="http://www.testwebsite.com/files/TestExcel.xlsx"
style="width:300px" />
完成上述步驟後,您可以直接在腳本代碼中訪問該值:
var excelUrl = $("#importUrl").val();
以下導入函數的代碼只使用本地文件作為「excelUrl」變量:
無論您是在伺服器上還是在本地引用文件,都需要在 $(document).ready函數內的腳本中添加以下內容:
將數據添加到Excel文件
在本教程中,我們以導入一個名為 「Profit loss statement」 的Excel模板為例。
Excel模板
現在我們可以使用Spread.Sheets腳本在此文件中添加另一個收入行。讓我們在頁面上添加一個按鈕來執行此操作:
Add Revenue
我們可以為該按鈕的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);
添加迷你圖
現在我們可以添加一個迷你圖來匹配其他數據行。要做到這一點,我們需要提供一系列單元格來獲取數據和一些迷你圖設置。在這種情況下,我們可以指定:
· 我們剛剛添加數據的單元格範圍
· 設置使迷你圖看起來像同一列中的其他迷你圖
然後,我們調用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加載文件時,在任何瀏覽器中都可以打開。
用SpreadJS 在網頁上實現的Excel模板
帶有用於添加收入行按鈕的Excel模板
添加Excel導出代碼
我們還可以實現:在網頁中將帶有添加行功能的Spread.Sheets 導出成Excel文件。在這裡,我們使用Spread.Sheets中內置的客戶端ExcelIO代碼:
該代碼從exportFileName的輸入元素中直接獲取導出的文件名。我們可以定義它並讓用戶以這樣的方式命名文件:
在這裡,我們繼續為調用此函數添加一個按鈕:
Export File
document.getElementById("export").onclick = function () {
ExportFile();
}
導入和編輯Excel文件後完成的頁面
在實現添加行功能後,可以使用「導出文件」的按鈕導出Excel。請確保添加FileSaver外部庫,以便用戶將文件保存到他們本地: