转载自我的个人主页
前言
在开发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 src="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)
},