首页手记 Office加载项对Excel进行读写操作

Office加载项对Excel进行读写操作

标签：

JavaScript

前言

在开发ExcelWeb插件的时候，一大亮点就是可以在web项目中操作Excel，读取Excel的内容，也可以将服务端的数据写入的 Excel中，大大方便的用户使用Excel，提高工作效率

Ranges

Ranges表示Excel的区域，例如一个单元格的区域是=A1,多个单元格的区域，B1:B4表示连续的4个单元格，对Excel 内容的读写，即是对Ranges的读写。

Ranges的属性

address，表示Ranges的地址，例如：A1，B1:B4
values,二维数组，表示区域的实际值
texts,二维数组，表示区域的展示值
formulas,二维数组，表示区域的公式，excel可以使用公式，使用之后，看到的值是公式计算之后的值，如果想要知道使用了那些公式，就需要使用formulas属性
format，区域的字体格式，可以该表文字字体，颜色，也可以改变区域的背景色。

numberFormat,二维数组，区域的格式，有文本、日期、数值等，和Excel右击设置单元格的格式里所有的格式一致

格式	值
General	General
Number	0
Currency	$#,##0.00;[Red]$#,##0.00
Accounting	($ #,##0.00);($* (#,##0.00);($ "-"??);(@_)
Date	m/d/yy
Time	[$-F400]h:mm:ss am/pm
Percentage	0.00%
Fraction	# ?/?
Scientific	0.00E+00
Text	@
Special	;;
Custom	#,##0_);Red
来源	Stack Overflow上的回答

Ranges的方法

load(),表示接下来你要使用哪个属性，需要在此处表明，例如，你要使用address，则 range.load('address')。
clear(),清空该区域
delete(),删除该区域，并指定是否需要下面的值上移，或者右面的值左移，参数枚举值如下：
- Excel.DeleteShiftDirection.up:删除后，下面的值，向上移动填充空值
- Excel.DeleteShiftDirection.left:删除后，右面的值，向左移动填充空值
select()，选中该区域
copyFrom(),将指定区域的值复制给当前区域

具体用法

准备工作：

首先在vue中要安装excel-addin

npm install excel-addin --save

在index.html中假如office.js

  <script class="lazyload" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAANSURBVBhXYzh8+PB/AAffA0nNPuCLAAAAAElFTkSuQmCC" data-original="https://appsforoffice.microsoft.com/lib/1/hosted/office.js"></script>

如果想要在Excel初始化时做些什么，还需要在main.js中假如下面的代码

const Office = window.Office
Office.initialize = () => {    //初始化内容}

操作Excel的行为均要写在特定方法里，即：

//其中context表示Excel的上下文，操作Excel的东西均通过该参数
 Excel.run(function(context) {     //此处写操作Excel的方法
     //处理完之后要提交，Excel才会识别，另外所有的//读写数据的操作均在，
     //context.sync().then(=>{
         //此处读写数据
     })     return context.sync()
 }

写入

    write: function() {
      Excel.run(function(context) {        //获取指定名字的工作薄sheet
        // var sheet = context.workbook.worksheets.getItem('sheetName')
        //获取当前活动工作薄
        var sheet = context.workbook.worksheets.getActiveWorksheet()        var data = [
          ['Product', 'Qty', 'Unit Price', 'Total Price'],
          ['Almonds', '2', '7.5', '15'],
          ['Coffee', '1', '34.5', '34.5'],
          ['Chocolate', '5', '9.56', '47.8'],
          ['', '', '', '97.3']
        ]        //此二维数组的长度要和数据的保持一致，否则无效
        var formats = [
          ['@', '@', '@', '@'], //设置格式为文本
          ['0.00', '0.00', '0.00', '0.00'],
          ['0.00', '0.00', '0.00', '0.00'],
          ['0.00', '0.00', '0.00', '0.00'],
          ['0.00', '0.00', '0.00', '0.00']
        ]        var range = sheet.getRange('A1:D5')        //选中该区域
        range.select()        // 设置背景色和字体
        range.format.fill.color = '#4472C4'
        range.format.font.color = 'white'
        //设置区域的格式
        range.numberFormat = formats        //表示加载values属性，如果不加载在下面是不可以使用的
        range.load('values')        return context.sync().then(function() {          //写入方法必须在该方法内执行才有效
          range.values = data
        })
      }).catch(_this.errorHandler)
    },

读取数据

read: function() {      let _this = this
      Excel.run(function(context) {        //获取指定名字的工作薄sheet
        // var sheet = context.workbook.worksheets.getItem('sheetName')
        // 获取当前选中的单元格
        var range = context.workbook.getSelectedRange()        //获取当前选中的单元格
        //表示加载以下属性，如果不加载在下面是不可以使用的
        range.load('values')
        range.load('address')
        range.load('formulas')
        range.load('text')        return context.sync().then(function() {          //写入方法必须在该方法内执行才有效
          _this.content = {            values: range.values,            formulas: range.formulas,            address: range.address,            texts: range.text
          }          console.log(_this.content)
        })
      }).catch(_this.errorHandler)
    }

删除某一行数据

deleteOne: function() {      let _this = this
      Excel.run(function(context) {        //获取指定名字的工作薄sheet
        // var sheet = context.workbook.worksheets.getItem('sheetName')
        // 获取当前选中的单元格
        var sheet = context.workbook.worksheets.getActiveWorksheet()        var range = sheet.getRange('A2:D2')
        range.delete(Excel.DeleteShiftDirection.up)        //提交操作
        return context.sync()
      }).catch(_this.errorHandler)
    },

清空所有数据

clear: function() {      let _this = this
      Excel.run(function(context) {        //获取指定名字的工作薄sheet
        // var sheet = context.workbook.worksheets.getItem('sheetName')
        // 获取当前选中的单元格
        var sheet = context.workbook.worksheets.getActiveWorksheet()        var range = sheet.getRange('A1:D4')
        range.clear()        //提交操作
        return context.sync()
      }).catch(_this.errorHandler)
    },