WPS Excel JS学习笔记

学习目标

• 掌握WPS Excel JS入门知识
• 使用JS脚本提升自动化办公水平
• 以"万物皆可为对象"的思维学习（对象包含属性和方法）

---

入门准备

1. 参考资料WPS开放平台
2. 参考资料W3school
3. 参考资料MrFlySand-飞沙. (2021). WPS JS宏教程文档，0基础入门，超详细~. [在线]. 博客园博客
4. 启用开发工具切换宏编辑器到JS开发环境
   

---

点滴笔记

1、录制宏与自定义函数区别

自定义函数和宏基本类似，主要不同点：
①.它们执行计算而不是操作，所以某些类型的语句，例如设置单元格的值、修改选区等不建议写在自定义函数中
②.宏通常不会有参数和返回值，而函数在参数上没有限制，往往是有返回值的

但在我看来，也没有那么死板，应该像编程一样自由设计模块。我们知道，录制宏是WPS Excel官方自带的，它能通过宏录制器捕捉用户与WPS交互的操作，并以JS代码形式记录下来，因此录制宏时常用来寻找写JS脚本的灵感

2、JS样式指南

代码约定确保代码质量，既可以改善代码可读性，也可以提升代码可维护性

• 变量和函数一般使用小驼峰法标识（即除第一个单词之外，其他单词首字母均大写），比如lastName、fullPrice等；或者全小写字母，通过下划线连接起来，比如my_function、my_error等
• 全局变量、常量通常为大写
• 严格区分字母大小写，不可以用数字开头
• 始终在运算符（ = + - * / ）周围以及逗号之后添加空格
• 代码块缩进始终使用 4 个空格
• 简单语句始终以分号结束单条语句，复杂语句通用规则：
  ①.将左花括号放在第一行的结尾
  ②.左花括号前添加一空格
  ③.将右花括号独立放在一行
  ④.以分号结束一个复杂的声明
• 对象定义通用规则：
  ①.将左花括号与类名放在同一行
  ②.冒号与属性值间有个空格
  ③.字符串使用双引号，数字不需要
  ④.最后一个属性-值对后面不要添加逗号
  ⑤.将右花括号独立放在一行，并以分号作为结束符号
• 建议每行长度小于80个字符，换行的最佳位置是在运算符或逗号之后

3、自定义函数结构

关键字：function
函数名：支持中英文
标点符号：在英文输入法下使用各标点符号

function 计算面积(长, 宽)
{
   
   if (宽 == undefined)
   	return 长*长
   else
   	return 长*宽
}

function areaCalculation(length, width)
{
   
   if (width== undefined)
   	return length*length
   else
   	return length*width
}

4、常见基本语法

• WPS JS脚本每条语句后面要么都有";“，要么都没有”;"，保持统一风格，脚本运行不会报错
• 不同对象优先级，Application > Workbooks > Sheets > Range/Cells
• var、let与const声明的变量区别：
  ① var 变量的作用域在函数体内或者函数之外全局范围内，可以在声明之前使用，未声明变量的值为undefined
  ② let 变量的作用域在所在语句的代码块内，未声明直接使用系统会报错；在相同作用域内，不允许重复声明同一个变量
  ③ const 声明一个只读常量，声明之后不允许改变其值。因此，const 一旦声明必须初始化，否则会报错
• JavaScript 变量属于本地或全局作用域，全局变量可以通过闭包实现局部私有，局部变量只能用于其被定义的函数内部；拥有相同名称的全局变量和局部变量是不同的变量

4.1 工作簿

Application.Workbooks.Add()  // 表示新建一个工作簿
Application.Workbooks.Open(路径+文件名)  // 表示打开指定工作簿

Application.Workbooks.Item(n)  // 表示选中第n个已打开的工作簿
Application.Workbooks.Item("xxx.xlsx")  // 表示选中某个已打开的工作簿

Application.Workbooks.Item(n).Activate()  // 表示激活第几个已打开的工作簿
Application.Workbooks.Item("xxx.xlsx").Activate()  // 表示激活指定的工作簿
Application.Workbooks.Item(n).Save()  // 表示保存当前工作簿
Application.Workbooks.Item(n).SaveAs(路径+文件名)  // 表示另存为新的工作簿
Application.Workbooks.Item(n).Close()  // 表示关闭当前workbook对象

4.2 工作表

Sheets.Item(1)  // 表示选中第1个工作表，n表示第n个子表
Sheets.Item("xxx")  // 选中指定名字的工作表
...  // （其他属性和方法请参考官方文档）

4.3 单元格

// 选取单元格
ActiveSheet.Cells.Select()  // 全选当前活动表所有单元格
Range("D1:V45")  // 选择指定区域单元格
Range("A"+2)  // 选择A2单元格
Cells.Item(i,j)  // 选择某个单元格


// 读取或设置单元格的值
Range("D1:V45").Value2  // 获取指定区域单元格的值，Value2可用于单元格赋值
Range("D1:V45").Value()  // 获取指定区域单元格的值，不可用于单元格赋值


// 设置字体和单元格背景
Range("E7").Select();  // 选中单元格
Selection.Formula = "999";  // 单元格赋值
(obj=>{
   
	obj.