[[346693]]

 目前比較流行的辦公應用主要有Excel、WPS、石墨文檔等等，今天，猿妹要和大家推薦一款功能強大、配置簡單、完全開源的用純JavaScript編寫的前端表格庫，對它的評價只有【用它！】

Luckysheet具備了大部分Excel中的常用功能，比如文字與單元格的樣式調整與公式的使用等。除此之外還提供了獨有的復制時轉換格式（比如 json 等）以及其他格式的數據導入導出等，可以說Excel具備的常用功能它也都有了。

此外，因為Luckysheet采用純JavaScript編寫，因此它可以嵌入到任何前端項目或應用程序中，便于實現集成和自動化。不過在圖表方面現在只支持了常用的ECharts，其他圖表框架需要等待以后陸續支持。

目前，Luckysheet已經在GitHub上標星3.9K，累計分支292（GitHub地址：https://github.com/mengshukeji/Luckysheet/blob/master/README-zh.md）

整體架構

首先我們一起來看看Luckysheet的格式，一個完整的Luckysheet表格文件的數據格式為：luckysheetfile，一個表格文件包含若干個sheet文件，對應excel的sheet0、sheet1等。

一個Luckysheet文件的示例如下，該表格包含3個sheet：luckysheetfile = [ {sheet1設置}, {sheet2設置}, {sheet3設置} ] 相當于excel的3個sheet

文件中的一個sheet的數據luckysheetfile[0]的結構如下：

{ 
    "name": "Cell", //工作表名稱 
    "color": "", //工作表顏色 
    "index": "0", //工作表索引 
    "status": "1", //激活狀態 
    "order": "0", //工作表的順序 
    "hide": 0,//是否隱藏 
    "row": 36, //行數 
    "column": 18, //列數 
    "config": { 
        "merge":{}, //合并單元格 
        "rowlen":{}, //表格行高 
        "columnlen":{}, //表格列寬 
        "rowhidden":{}, //隱藏行 
        "colhidden":{}, //隱藏列 
        "borderInfo":{}, //邊框 
    }, 
    "celldata": [], //初始化使用的單元格數據 
    "data": [], //更新和存儲使用的單元格數據 
    "scrollLeft": 0, //左右滾動條位置 
    "scrollTop": 315, //上下滾動條位置 
    "luckysheet_select_save": [], //選中的區域 
    "luckysheet_conditionformat_save": {},//條件格式 
    "calcChain": [],//公式鏈 
    "isPivotTable":false,//是否數據透視表 
    "pivotTable":{},//數據透視表設置 
    "filter_select": {},//篩選范圍 
    "filter": null,//篩選配置 
    "luckysheet_alternateformat_save": [], //交替顏色 
    "luckysheet_alternateformat_save_modelCustom": [], //自定義交替顏色     
    "freezen": {}, //凍結行列 
    "chart": [], //圖表配置 
    "visibledatarow": [], //所有行的位置 
    "visibledatacolumn": [], //所有列的位置 
    "ch_width": 2322, //工作表區域的寬度 
    "rh_height": 949, //工作表區域的高度 
    "load": "1", //已加載過此sheet的標識 
} 

在chrome的console中查看 luckysheet.getluckysheetfile() 可以看到完整設置 [{shee1}, {sheet2}, {sheet3}]

使用方法

第一步，引入依賴，有2種方式：

CDN

<link rel='stylesheet' href='https://cdn.jsdelivr.net/npm/luckysheet/dist/plugins/css/pluginsCss.css' /> 
 
<link rel='stylesheet' href='https://cdn.jsdelivr.net/npm/luckysheet/dist/plugins/plugins.css' /> 
 
<link rel='stylesheet' href='https://cdn.jsdelivr.net/npm/luckysheet/dist/css/luckysheet.css' /> 
 
<script src="https://cdn.jsdelivr.net/npm/luckysheet/dist/plugins/js/plugin.js"></script> 
 
<script src="https://cdn.jsdelivr.net/npm/luckysheet/dist/luckysheet.umd.js"></script> 

注意，https://cdn.jsdelivr.net/npm/luckysheet/dist/luckysheet.umd.js這個路徑會拉取到最新的luckysheet代碼，想要指定luckysheet版本，請在luckysheet后面加上版本號，如：https://cdn.jsdelivr.net/npm/luckysheet@2.0.0/dist/luckysheet.umd.js

如果不方便訪問 jsdelivr.net，還可以采用本地方式引入

本地引入

npm run build后dist文件夾下的所有文件復制到項目目錄，然后通過相對路徑引入

<link rel='stylesheet' href='./plugins/css/pluginsCss.css' /> 
 
<link rel='stylesheet' href='./plugins/plugins.css' /> 
 
<link rel='stylesheet' href='./css/luckysheet.css' /> 
 
<script src="./plugins/js/plugin.js"></script> 
 
<script src="./luckysheet.umd.js"></script> 

第二步，指定一個表格容器

<div id="luckysheet" style="margin:0px;padding:0px;position:absolute;width:100%;height:100%;left: 0px;top: 0px;"></div> 

第三步，創建表格

<script> 
 
$(function () { 
 
//配置項 
 
var options = { 
 
container: 'luckysheet' //luckysheet為容器id 
 
} 
 
luckysheet.create(options) 
 
}) 
 
</script> 

其實LuckysheetDocs的使用方式和Excel差別并不大，就連快捷鍵也是一樣的：

最后附上在線DEMO體驗：