> ## 组件 wl-down-excel 使用文档 ``` <wl-down-excel name="下载excel" api-url="http://sstpw.tripln.top/wl/selectCouponTest" :header="header" :down-data="downData" :mergeArray="mergeArray" scp-design="false" ></wl-down-excel> ``` ### wl-down-excel props | 属性 | 说明 | 类型 | 默认值 | | --- | --- | --- | --- | | name | 按钮名称 | String | '' | | api-url | excel数据接口地址 | String | '' | | header | 表头 | Array | [] | | down-data | 接口失效的默认数据 | Array | [] | | mergeArray | 合并单元格配置 | Array | [] | | styleObj | 配置单元格样式，包括位置、字体、颜色等 | Object | {} | ### 备注说明 - #### 合并单元格说明 > header 是一个字符串的二维数组，header[0] 存的是属性的数组，剩余的是按行排列的表头，每一个数组元素都是个数组，代表 excel 中的一行，**当存在单元格合并的时候，相关的数组元素需要用 null 占位**。例子如下面代码所示。 ``` [['name', 'score', 'total'],['姓名', '期中考试成绩', null, null, null, null, '总分']] ``` > mergeArray 是一个对象数组，用于配置合并表头，数组的每个元素具体如下代码所示。s 代表开始单元格(start)， e 代表结束单元格(end)。c 代表列(column)，c:0，代表A列以此类推。r 代表行(row)，r:0，代表1行以此类推。 ``` { s: { c: 3, r: 2 }, e: { c: 5, r: 2 } } ``` - #### 单元格格式配置说明 > styleObj 是一个对象，用于配置单元格样式，**合并单元格的情况下配置左上角第一个单元格即可** 以下为配置 A1 单元格垂直水平居中，字号为20，字体颜色为红色 ``` { A1: { font: { sz: 20, color: { rgb: 'FF0000' } }, alignment: { vertical: 'center', horizontal: 'center' } } } ``` 详细配置请参考以下文档 [xlsx-style 英文文档](https://github.com/protobi/js-xlsx) 下面链接是目前发现比较全的中文配置。打开后全文搜索“单元格样式” [xlsx-style 配置中文版](https://segmentfault.com/a/1190000022772664)