前端使用xlsx库导出带有样式的excel文件

 更新时间:2022年08月05日 16:33:44   作者:callMe小王  
这篇文章主要为大家介绍了前端使用xlsx库导出带有样式的excel文件示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

需求分析

最近遇到一个需求:前端导出excel文件,其中有部分数据用户不能操作,部分列数据可以筛选,并且存在前一列的数据值会影响后一列数据值的输入范围的情况。

需要导出的前端表格如上图所示,其中:

  • Group、Type、Region可筛选
  • 红色框内的数据用户不可操作,绿色框内用户可以操作
  • 当Type的值为BOOL时,Region的有效输入为:["Holding Register","Input Register"],否则为:["Coil","Discrete Input"]
  • Address的输入范围为:[0,65535]

项目使用的是React + AntD

常用的库

在这个需求出来之前,前端导入导出excel文件时我使用的是xlsx这个库。但是,如果想要修改excel表格样式的话,是需要使用收费的专业版本。带着开源第一,绝不花钱的基本原则,本人就找到了ExcleJS这个库。

ExcleJS

ExcleJS不仅完全开源,还配备着中文文档这可真的是用着放心也开心!

具体实现

安装:

npm install exceljs
npm install file-saver 

创建workbook,添加名为Demo的sheet,设置默认行高为20,设置列(表头);

添加行信息(allData前端页面表格中的数据);

最后给表头添加颜色。

    // 创建工作簿
    const workbook = new ExcelJs.Workbook();
    // 添加sheet
    const worksheet = workbook.addWorksheet('Demo');
    // 设置 sheet 的默认行高
    worksheet.properties.defaultRowHeight = 20;
    // 设置列
    worksheet.columns = [
      { header: 'Index', key: 'index', width: 10 },
      { header: 'Name', key: 'name', width: 25 },
      { header: 'Type', key: 'group', width: 25, outlineLevel: 1 },
      { header: 'Group', key: 'type', width: 25, outlineLevel: 1 },
      { header: 'Region', key: 'modbusRegion', width: 25, outlineLevel: 1 },
      { header: 'Address', key: 'modbusAddress', width: 25, outlineLevel: 1 },
    ];
    // 添加行
    worksheet.addRows(allData);
    // 给表头添加背景色
    let headerRow = worksheet.getRow(1);
    headerRow.eachCell((cell) => {
      cell.fill = {
        type: 'pattern',
        pattern: 'solid',
        fgColor: {argb: 'dde0e7'},
      }
    })
  • 将自动筛选器设置为从 A2 到 F1 (Group、Type、Region)
    // 将自动筛选器设置为从 A2 到 F1
    worksheet.autoFilter = {
      from: 'C1',
      to: 'E1',
    }
  • 锁定整个excel表格,可筛选但不能选中锁定的单元格
    // 锁定工资表
    await worksheet.protect('the-password', 
                             {
                              autoFilter:true,
                              selectLockedCells:false,
                              });
  • 通过循环判断,哪些单元格可以被用户操作,并且判断该单元格的输入限制是什么
   const allData = [...this.state.dataSource]
   let length = allData.length
   for(let i = 0 ;i < length; i++){
      // Region的输入范围
      let coilArr = ['"Coil,Discrete Input"']
      let registerArr = ['"Holding Register,Input Register"']
      let listArr = []
      if(allData[i].type === 'BOOL'){
        listArr = coilArr
      }
      else{
        listArr = registerArr
      }
      // 可编辑的单元格在E、F中
      worksheet.getCell(`E${i+2}`).protection = {
        locked: false,
      };
      // Region的输入校验
      worksheet.getCell(`E${i+2}`).dataValidation = {
        type: 'list',
        allowBlank: true,
        formulae: listArr,
        showErrorMessage: true,
        errorTitle: '非法输入',
        error: '取值范围为:'+listArr
      };
      worksheet.getCell(`F${i+2}`).protection = {
        locked: false,
      };
      // Address的输入校验
      worksheet.getCell(`F${i+2}`).dataValidation = {
        type: 'whole',
        operator: 'between',
        allowBlank: true,
        showErrorMessage: true,
        formulae: [0,65535],
        errorTitle: '非法输入',
        error: '取值范围为:[0,65535]'
      };
    }

以上的代码中,worksheet.getCell(E${i+2}).dataValidation是进行单元格数据验证的函数,具体的使用可参考官方文档

  • 导出名为"xlsx-demo.xlsx"的excel文件
    // 导出excel
    this.saveWorkbook(workbook, 'xlsx-demo.xlsx');

结果展示

  • Group、Type、Region可筛选(✅)

  • 红色框内的数据,用户不可操作,蓝色框内用户可以操作(✅)

  • 当Type的值为BOOL时,Region的有效输入为:["Holding Register","Input Register"],否则为:["Coil","Discrete Input"](✅)

用户输入错误给出错误提醒,并且不保存错误数据。

  • Address的输入范围为:[0,65535](✅)

用户输入错误给出错误提醒,并且不保存错误数据。

整个函数展示

  // 导出xls
  exportXLS = async () =>{
    const allData = [...this.state.dataSource]
    let length = allData.length
    // 创建工作簿
    const workbook = new ExcelJs.Workbook();
    // 添加sheet
    const worksheet = workbook.addWorksheet('demo');
    // 设置 sheet 的默认行高
    worksheet.properties.defaultRowHeight = 20;
    // 设置列
    worksheet.columns = [
      { header: 'Index', key: 'index', width: 10 },
      { header: 'Name', key: 'name', width: 25 },
      { header: 'Group', key: 'group', width: 25, outlineLevel: 1 },
      { header: 'Type', key: 'type', width: 25, outlineLevel: 1 },
      { header: 'Region', key: 'modbusRegion', width: 25, outlineLevel: 1 },
      { header: 'Address', key: 'modbusAddress', width: 25, outlineLevel: 1 },
    ];
    // 添加行
    worksheet.addRows(allData);
    // 给表头添加背景色
    let headerRow = worksheet.getRow(1);
    // 通过 cell 设置背景色,更精准
    headerRow.eachCell((cell) => {
      cell.fill = {
        type: 'pattern',
        pattern: 'solid',
        fgColor: {argb: 'dde0e7'},
      }
    })
    // 将自动筛选器设置为从 C1 到 F1
    worksheet.autoFilter = {
      from: 'C1',
      to: 'E1',
    }
    // 锁定工资表
    await worksheet.protect('the-password', 
                             {
                              autoFilter:true,
                              selectLockedCells:false,
                              });
    // 判断哪些单元格可以被用户操作,并且判断该单元格的输入限制是什么
    for(let i = 0 ;i < length; i++){
      // 根据不同类型选择筛选的框
      let coilArr = ['"Coil,Discrete Input"']
      let registerArr = ['"Holding Register,Input Register"']
      let listArr = []
      if(allData[i].type === 'BOOL'){
        listArr = coilArr
      }
      else{
        listArr = registerArr
      }
      // 可编辑的单元格在E、F中
      worksheet.getCell(`E${i+2}`).protection = {
        locked: false,
      };
      worksheet.getCell(`E${i+2}`).dataValidation = {
        type: 'list',
        allowBlank: true,
        formulae: listArr,
        showErrorMessage: true,
        errorTitle: '非法输入',
        error: '取值范围为:'+listArr
      };
      worksheet.getCell(`F${i+2}`).protection = {
        locked: false,
      };
      worksheet.getCell(`F${i+2}`).dataValidation = {
        type: 'whole',
        operator: 'between',
        allowBlank: true,
        showErrorMessage: true,
        formulae: [0,65535],
        errorTitle: '非法输入',
        error: '取值范围为:[0,65535]'
      };
    }
    // 导出excel
    this.saveWorkbook(workbook, 'xlsx-demo.xlsx');
  }

最后

ExcelJS 功能很强大,如合并单元格、合并行和列、修改单元格的样式、设置页眉页脚、操作视图、添加公式、使用富文本等功能都是可以实现的。

官方文档十分详细,大家有需求的话直接看官方文档

以上就是前端使用xlsx库导出带有样式的excel文件的详细内容,更多关于前端xlsx库导出excel的资料请关注脚本之家其它相关文章!

相关文章

  • Vite项目自动添加eslint prettier源码解读

    Vite项目自动添加eslint prettier源码解读

    这篇文章主要为大家介绍了Vite项目自动添加eslint prettier源码解读,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-12-12
  • JavaScript版代码高亮

    JavaScript版代码高亮

    JavaScript版代码高亮...
    2006-06-06
  • 一文详解typeScript的extends关键字

    一文详解typeScript的extends关键字

    这篇文章主要为大家介绍了typeScript的extends关键字使用示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-03-03
  • 微信小程序 navigation API实例详解

    微信小程序 navigation API实例详解

    这篇文章主要介绍了微信小程序 navigation API实例详解的相关资料,需要的朋友可以参考下
    2016-10-10
  • webpack安装配置及使用教程详解

    webpack安装配置及使用教程详解

    这篇文章主要为大家介绍了webpack的安装配置及使用的教程示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06
  • nuxt.js 多环境变量配置

    nuxt.js 多环境变量配置

    这篇文章主要介绍了nuxt.js 多环境变量配置,一般在香米开发中会有三个环境开发环境也叫测试环境(test) 、RC环境也叫预发布环境(rc) 、线上环境(production) 下面来看看文章内容的详细介绍,需要的朋友可以参考一下
    2021-11-11
  • quickjs 封装 JavaScript 沙箱详情

    quickjs 封装 JavaScript 沙箱详情

    这篇文章主要介绍了 quickjs 封装 JavaScript 沙箱,在前文 JavaScript 沙箱探索 中声明了沙箱的接口,并且给出了一些简单的执行任意第三方 js 脚本的代码,但并未实现完整的 IJavaScriptShadowbox,下面便讲一下如何基于 quickjs 实现,需要的朋友可以参考一下
    2021-10-10
  • 深入理解函数执行上下文 this

    深入理解函数执行上下文 this

    这篇文章主要为大家介绍了深入理解函数执行上下文 this示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-10-10
  • 详解无界微前端是如何渲染子应用的demo解析

    详解无界微前端是如何渲染子应用的demo解析

    这篇文章主要为大家介绍了详解无界微前端是如何渲染子应用demo解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • 在微信小程序中渲染HTML内容3种解决方案及分析与问题解决

    在微信小程序中渲染HTML内容3种解决方案及分析与问题解决

    在开发微信小程序时我们会在小程序内加入纯HTML代码,且HTML中包括图片,视频,甚至是事件,微信小程序为我们提供了3种解决方法,但它们的功能与实现方式与最终效果并不理想
    2020-01-01

最新评论