如何使用JavaScript匯入和匯出Excel檔案

葡萄城技術團隊發表於2019-07-05
JavaScriptExcel

本文由葡萄城技術團隊於原創並首發

轉載請註明出處：葡萄城官網，葡萄城為開發者提供專業的開發工具、解決方案和服務，賦能開發者。

 

JavaScript是一個涵蓋多種框架、直譯式、可以輕鬆自定義客戶端的指令碼語言，在 Web 應用程式中，更加易於編碼和維護。而Excel 作為一款深受使用者喜愛的電子表格工具，藉助其直觀的介面、出色的計算效能和圖表工具，已經成為資料統計領域不可或缺的軟體之一。

如果有一款產品，能夠將二者完美融合，將在前端表格資料處理、資料填報、資料視覺化、線上文件等領域大放異彩。SpreadJS，正是這樣一款功能佈局與Excel高度類似，無需大量程式碼開發和測試即可實現資料展示、前端 Excel 匯入匯出、圖表皮膚、資料繫結等業務場景的純前端表格控制元件。

使用JavaScript實現 Excel 的匯入和匯出

通過純JavaScript，您完全可以實現匯入和匯出Excel檔案功能，併為終端使用者提供與這些檔案進行I/O互動的介面。在本篇教程中，我將向您展示如何藉助SpreadJS，在JavaScript中輕鬆實現匯入和匯出Excel檔案的操作，以及將SpreadJS元件新增到HTML頁面是多麼的容易。

匯入和編輯Excel檔案後完成的頁面

 

工欲善其事，必先利其器

請下載SpreadJS 純前端表格控制元件，以便同步體驗

設定JavaScript的電子表格專案

建立一個新的HTML頁面並新增對SpreadJS下載包中Spread.Sheets指令碼和CSS檔案的引用：

<!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 檔案：

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”變數：

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函式內的指令碼中新增以下內容：

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

將資料新增到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：

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載入檔案時，在任何瀏覽器中都可以開啟。

用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) {  
            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檔案後完成的頁面

在實現新增行功能後，可以使用“匯出檔案”的按鈕匯出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 檔案。您可以在SpreadJS產品官網，檢視本篇教程並下載Demo示例。

本篇教程，僅展示了SpreadJS 的部分功能，即前端匯入、匯出Excel檔案，更多的功能如資料分析、列印、匯出PDF、自定義公式函式等，請前往SpreadJS產品官網瞭解更多。

相關文章