如何在Node.js中使用xlsx-style来定制表格的宽度和高度?附带示例代码
传送门
先放一些我认为非常优秀的参考文档,作为传送门集合,方便大家查看吧:
【1】Node.js中如何利用xlsx设置导出表格的样式? 这个问题告诉了你,你用xlsx设置样式不行,但是用xlsx-style导出样式就ok
【2】纯前端利用 js-xlsx 实现 Excel 文件导入导出功能示例 这算是全网,注意是全网讲解js-xlsx比较全面系统的文章了,可以好好了解一下。
本系统使用node+express 作为后台,导出excel使用的是xlsx-style。在开始之前,先简单介绍一下node常用的一些导出excel的工具,因为这对我们后面的工作十分重要。
预备
(1)js-xlsx和xlsx。xlsx和js-xlsx可以理解为基本库,API十分复杂,上手难度高,但是你想要的功能,基本上都有。但是文档不好,看起来十分费力。不信你去点点下面的链接看看,吓死你……
js-xlsx文档:www.npmjs.com/package/js-… xlsx文档:www.npmjs.com/package/xls…
(2)node-xlsx。基于基本库的封装,底层的库是用的xlsx。
node-xlsx npm文档:www.npmjs.com/package/nod…
十分操蛋的文档,反正我是看完之后不知道怎么用,写了跟没写一样,关键的样式都没说。
(3)xlsx-style 基于xlsx封装的样式库,可以在xlsx的基础上设置样式。
正文
一般在使用node的时候我们是直接使用node-xlsx库的,关键的导出代码如下:
const xlsx = require('node-xlsx').default;
const options = {
'!cols': [
{wpx: 300},//1-变更名称
{wpx: 100},//2-变更描述
{wpx: 140},//3-计划上线测试时间
{wpx: 140}, //4-计划上线时间
{wpx: 250}, //5-子系统、模块名称
{wpx: 120}, //6-依赖模块
{wpx: 195},//7-功能点
{wpx: 195}, //8-详细描述
{wpx: 195}, //9-测试要点
{wpx: 205}, //10-对应需求
{wpx: 150}, //11-是否
{wpx: 150}, //12-开发A
{wpx: 150}, //13-开发B
{wpx: 110}, //14-关联版本
{wpx: 110}, //15-代码走查
],
'!rows': [
{hpx: 40,},
{hpx: 60},
{hpx: 80},
{hpx: 100},
],
'!margins': {left: 0.7, right: 0.7, top: 0.75, bottom: 0.75, header: 0.3, footer: 0.3},
}
const range = {s: {c: 0, r: 0}, e: {c: 0, r: 2}}; // A1:A4
options['!merges'] = [range]
const xlsxData = xlsx.build([form], options)
options是导出表格的一些样式,!cows和!rows分别设置的是列宽和行高,可以成功设置,但是样式不能成功设置,也就是说
s标签里的东西通通无效。
在网上查询了一些办法后,发现主需要吧node-xlsx里对xlsx的引入改为xlsx-style就能够成功设置样式。
然后就发现了样式成功设置,行高却无效了……(我tm!@#¥%)
问题分析
我对比了xlsx-style和xlsx的源码,发现两个库很多的方法和代码都是一样的,xlsx-style之所以能够设置样式,是因为它多了一个styleBuilder
而xlsx-style不能够设置行高,是因为在write_ws_xml-data里没有对rows进行处理,而在xlsx库里可以清楚的看到它对!rows的处理
所以解决方法就必须去改库(我认为),思路也有2中: (1)在xlsx-style加xlsx里设置行高的代码 (2)在xlsx里加入xlsx-style里设置样式的代码
用脚想也应该知道(1)的工作量最小,所以解决办法就是在xlsx-style里加入行高设置的代码。
解决方法:
先修改node-xlsx lib目录下的hepler.js
var buildSheetFromMatrix = function buildSheetFromMatrix(data) {
var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
var workSheet = {};
var range = {s: {c: 1e7, r: 1e7}, e: {c: 0, r: 0}};
if (!Array.isArray(data)) throw new Error('sheet data is not array');
for (var R = 0; R !== data.length; R += 1) {
for (var C = 0; C !== data[R].length; C += 1) {
if (!Array.isArray(data[R])) throw new Error(R + 'th row data is not array');
if (range.s.r > R) range.s.r = R;
if (range.s.c > C) range.s.c = C;
if (range.e.r < R) range.e.r = R;
if (range.e.c < C) range.e.c = C;
if (data[R][C] === null) {
continue; // eslint-disable-line
}
var cell = isCellDescriptor(data[R][C]) ? data[R][C] : {v: data[R][C]};
var cellRef = _xlsx2.default.utils.encode_cell({c: C, r: R});
if (isNumber(cell.v)) {
cell.t = 'n';
} else if (isBoolean(cell.v)) {
cell.t = 'b';
} else if (cell.v instanceof Date) {
cell.t = 'n';
cell.v = buildExcelDate(cell.v);
cell.z = cell.z || _xlsx2.default.SSF._table[14]; // eslint-disable-line no-underscore-dangle
} else {
cell.t = 's';
}
if (isNumber(cell.z)) cell.z = _xlsx2.default.SSF._table[cell.z]; // eslint-disable-line no-underscore-dangle
workSheet[cellRef] = cell;
}
}
if (range.s.c < 1e7) {
workSheet['!ref'] = _xlsx2.default.utils.encode_range(range);
}
if (options['!cols']) {
workSheet['!cols'] = options['!cols'];
}
if (options['!rows']) {
workSheet['!rows'] = options['!rows'];
}
if (options['!merges']) {
workSheet['!merges'] = options['!merges'];
}
return workSheet;
};
让opts里的rows能够被添加至workSheet当中
然后再修改在xlsx-style里的xlsx.js write_ws_xml_data 方法,添加设置行高的代码。
function write_ws_xml_data(ws, opts, idx, wb) {
var o = [], r = [], range = safe_decode_range(ws['!ref']), cell, ref, rr = "", cols = [], R, C,rows = ws['!rows'];
for(C = range.s.c; C <= range.e.c; ++C) cols[C] = encode_col(C);
for(R = range.s.r; R <= range.e.r; ++R) {
r = [];
rr = encode_row(R);
for(C = range.s.c; C <= range.e.c; ++C) {
ref = cols[C] + rr;
if(ws[ref] === undefined) continue;
if((cell = write_ws_xml_cell(ws[ref], ref, ws, opts, idx, wb)) != null) r.push(cell);
}
if(r.length > 0){
params = ({r:rr});
if(rows && rows[R]) {
row = rows[R];
if(row.hidden) params.hidden = 1;
height = -1;
if (row.hpx) height = px2pt(row.hpx);
else if (row.hpt) height = row.hpt;
if (height > -1) { params.ht = height; params.customHeight = 1; }
if (row.level) { params.outlineLevel = row.level; }
}
o[o.length] = (writextag('row', r.join(""), params));
}
}
if(rows) for(; R < rows.length; ++R) {
if(rows && rows[R]) {
params = ({r:R+1});
row = rows[R];
if(row.hidden) params.hidden = 1;
height = -1;
if (row.hpx) height = px2pt(row.hpx);
else if (row.hpt) height = row.hpt;
if (height > -1) { params.ht = height; params.customHeight = 1; }
if (row.level) { params.outlineLevel = row.level; }
o[o.length] = (writextag('row', "", params));
}
}
return o.join("");
}
结语
如果还有什么问题欢迎评论交流,最近一段时间都会折腾excel,所以会经常关注的。
详细的样式和完整的设置代码过段时间再补上~
先附上导出表格的效果图:
问题回复
【1】
这里再解释一下node-xlsx和xlsx的关系。首先node-xlsx是对xlsx的封装,简化了一些操作(这是我们在node项目里使用它比较重要的原因)
但是由于xlsx库没有对样式做处理,所以有人又在xlsx的基础上封装了样式,也就是xlsx-style库。
所以我们进行了从A到B的步骤,为的就是能够使用样式
在回到问题本身,只用xlsx-style的话肯定可以,修改的方法和上述一样。因为这种方法的核心就是去修改xlsx-style里的xlsx文件
只不过,如果只使用xlsx-style的话,那你需要一些额外的步骤去调用build方法,可以参看node-xlsx的处理(因为node-xlsx就是对xlsx的封装)这里再多说一句,其实xlsx库和xlsx-style库很多很多地方都非常相似,而后者主要增加了对样式的处理。
以上。(如果还有不明白的欢迎继续留言~)
--------------------------------------4月5日更新--------------------------------------------------
增加github的demo供大家参考~ github.com/huyifan/Nod… 欢饮大家讨论~
下一篇: CSS中的行高与盒高有何不同?
推荐阅读
-
如何在Node.js中使用xlsx-style来定制表格的宽度和高度?附带示例代码
-
Grid++Report 锐浪报表开发常见问题解答集锦-报表设计 问:怎样在设计时打印预览报表? 答:为了及时查看报表的设计效果,Grid++Report 报表设计应用程序提供了四种查看视图:普通视图、页面视图、预览视图与查询视图。通过窗口下边的 Tab 按钮可以在四种视图中任意切换。在预览视图中查看报表的打印预览效果,在查询视图中查看报表的查询显示效果。如果在报表的记录集提供了数据源连接串与查询 SQL,在进入预览视图与查询视图时会利用数据源连接串与查询 SQL 从数据源中自动取数,否则 Grid++Report 将自动生成模拟数据进行模拟打印预览与查询显示。注意:在预览视图与查询视图中看到的报表运行结果有可能与在你程序中的最终运行结果有差异,因为在报表的生成过程中我们可以在程序中对报表的生成行为进行一定的控制。 问:怎样用 Grid++Report 设计交叉表? 答:Grid++Report 没有提供专门实现交叉表的功能,其它的报表构件提供的交叉表功能一般也比较死板和功能有限。利用 Grid++Report 的编程接口可以做出灵活多变,功能丰富的交叉表。示例程序 CrossTab 就是一个实现交叉表的例子程序,认真领会此例子程序,你就可以做出自己想要各种交叉表,并能提取一些共用代码,便于重复使用。 问:怎样设置整个报表的缺省字体? 答:设置报表主对象的字体属性,也就是设置了整个报表的缺省字体。如果改变报表主对象的字体属性,则没有专门的设置字体属性的子对象的字体属性也跟随改变。同样每个报表节与明细网格也有字体属性,他们的字体属性也就是其拥有的子对象的缺省字体。 问:怎样在打印时限制一页的输出行数? 答:设定明细网格的内容行的‘每页行数(RowsPerPage)’属性即可。另外要注意‘调节行高(AdjustRowHeight)’属性值:为真时根据页面的输出高度自动调整行的高度,使整个页面的输出区域充满。为假时按设计时的高度输出行。 问:怎样显示中文大写金额? 答:将对象的“格式(Format)”属性设为 “$$” 及可,可以设置格式的对象有:字段(IGRField)、参数(IGRParameter)、系统变量(IGRSystemVarBox)与综合文字框(IGRMemoBox),其中综合文字框是在报表式上设格式。 问:能否实现自定义纸张与票据打印? 答:Grid++Report 完全支持自定义纸张的打印,只要在报表设定时在页面设置中选定自定义纸张,并指定准确的纸张尺寸。当然要在最终输出时得道合适的打印结果,输出打印机必须支持自定义纸张打印。Windows2000/XP/2003 操作系统上可以在打印机上定义自定义纸张,也可以采用这种方式实现自定义纸张打印。 问:怎样实现 0 值不打印? 答:直接设置格式串就可以,在“数字格式”设置对话框中选定“0 不显示”,就会得到合适的格式串。也可以通过直接录入格式串来指定 0 不显示,但格式串必须符合 Grid++Report 的规定格式。另一种实现办法是在报表获取明细记录数据时,在 BeforePostRecord 事件中将值为零的字段设为空,调用字段的 Clear 方法将字段置为空。 问:怎样实现多栏报表? 答:在明细网格上设‘页栏数(PageColumnCount)’属性值大于 1 即可。通过 Grid++Report 的“页栏输出顺序”还可以指定多栏报表的输出顺序是“先从上到下”还是“先从左到右”。 问:如何实现票据套打? 答:Grid++Report 为实现票据套打做了很多专门的安排:报表设计器提供了页面设计模式,按照设定的纸张尺寸显示设计面板,如果将空白票据的扫描图设为设计背景图,在定位报表内容的输出位置会非常方便。报表部件可以设定打印类别,非套打输出的内容在套打打印模式下就不会输出。 问:Grid++Report 有没有横向分页功能? 答:回答是肯定的,在列的总宽度超过打印页面的输出宽度时,Grid++Report 可以另起新页输出剩余的列,如果左边存在锁定列,锁定列可以在后面的新页中重复输出,这样可以保证关键数据列在每一页都有输出。仔细体会 Grid++Report 提供的多种打印适应策略,选用最合适的方式。Grid++Report 的多种打印适应策略为开发动态报表提供了很好的支持。 问:怎样实现报表本页小计功能? 答:定义一个报表分组,将本分组定义为页分组,在本分组的分组头与分组尾上定义统计。页分组就是在每页产生一个分组项,在每页的上端与下端都会分别显示页分组的分组头与分组尾,页分组不用定义分组依据字段。 报表运行 问:怎样与数据库建立连接? 答:如果在设计报表时指定了数据集的数据源连接串与查询 SQL 语句,Grid++Report 采用拉模式直接从数据源取得报表数据,Grid++Report 利用 OLE DB 从数据源取数,OLE DB 提供了广泛的数据源操作能力。如果 Grid++Report 的数据来源采用推模式,即 Grid++Report 不直接与数据库建立连接,各种编程语言/平台都提供了很好的数据库连接方式,并且易于操作,应用程序在报表主对象(IGridppReport)的 FetchRecord 事件中将数据传入,例子程序提供了各种编程语言填入数据的通用方法,对C++Builder 和 Delphi 还进行了专门的包装,直接关联 TDataSet 对象也可以将 TDataSet 对象中的数据传给报表。 问:打印时能否对打印纸张进行自适应?支持表格的折行打印吗? 答:Grid++Report 在打印时采用多种适应策略,通过设置明细网格(IGRDetailGrid)的‘打印策略(PrintAdaptMethod)’属性指定打印策略。(1)丢弃:按设计时列的宽度输出,超出范围的内容不显示。(2)绕行:按设计时列的宽度输出,如果在当前行不能完整输出,则另起新行进行输出。(3)缩放适应:对所有列的输出宽度进行按比例地缩放,使总宽度等于页面的输出宽度。(4)缩小适应:如果列的总宽度小于页面的输出宽度,对所有列的输出宽度进行按比例地缩小,使总宽度等于页面的输出宽度。(5)横向分页:超范围的列在新页中输出。(6)横向分页并重复锁定列。 问:如何改变缺省打印预览窗口的窗口标题? 答:改变报表主对象的‘标题(Title)’属性即可。 问:利用集合对象的编程接口取子对象的接口引用,但不是自己期望的结果。 答:Grid++Report中所有集合对象的下标索引都是从 1 开始,另按对象的名称查找对象的接口引用时,名称字符是不区分大小写的。 问:怎样在运行时控制报表中各个对象的可见性?即怎样在运行时显示或隐藏对象? 答:在报表主对象(GridppReport)的 SectionFormat 事件中设定相应报表子对象的可见(Visible)属性即可。 问:报表主对象重新载入数据,设计器中为什么没有反映新载入的数据? 答:应调用 IGRDesigner 的 Reload 方法。 问:怎样实现不进入打印预览界面,直接将报表打印出来?