WPS Writer JS API 核心参考
代码执行环境
- 代码通过
new Function(code)() 在 WPS Plugin Host 中同步执行
- 全局可用对象:
Application, wps
- 必须使用
var 声明变量（不支持 let/const/箭头函数）
- 最后一行必须返回结果字符串
常用对象
Application.ActiveDocument // 当前文档 (Document)
Application.Selection // 当前选区 (Selection)
Document.Content // 全文 Range
Document.Paragraphs // 段落集合 Paragraphs
Document.Tables // 表格集合 Tables
Document.Sections // 节集合 Sections
Document.Bookmarks // 书签集合
Selection 操作
Selection.Text // 读取/设置选区文本
Selection.TypeText(text) // 在光标处输入（替换选区）
Selection.InsertAfter(text) // 在选区后插入
Selection.InsertBefore(text) // 在选区前插入
Selection.MoveDown(unit, count) // 下移光标
Selection.MoveRight(unit, count) // 右移光标
Selection.Collapse(direction) // 收缩选区 (0=wdCollapseEnd, 1=wdCollapseStart)
Selection.WholeStory() // 选中全文
Selection.HomeKey(unit) // 移动到文档/行首
Selection.EndKey(unit) // 移动到文档/行尾
Range 操作
Range.Text // 读取/设置文本
Range.InsertAfter(text) // 在范围后插入
Range.InsertBefore(text) // 在范围前插入
Range.Start / Range.End // 起止字符位置
Range.Select() // 将此范围设为选区
Range.Delete() // 删除范围内容
格式化
Range.Font.Name = "微软雅黑"
Range.Font.Size = 14
Range.Font.Bold = true / false
Range.Font.Italic = true / false
Range.Font.Color = 0xFF0000 // BGR 颜色
Range.Font.Underline = 1 // wdUnderlineSingle
Range.ParagraphFormat.Alignment = 1 // 0=左, 1=居中, 2=右, 3=两端
Range.ParagraphFormat.LineSpacing = 24 // 行距 (磅)
Range.ParagraphFormat.SpaceBefore = 6
Range.ParagraphFormat.SpaceAfter = 6
Range.ParagraphFormat.FirstLineIndent = 24 // 首行缩进
Range.Style = "标题 1" // 设置样式
表格操作
Document.Tables.Add(range, rows, cols)
Table.Cell(row, col).Range.Text = "文本"
Table.Rows.Add()
Table.Columns.Add()
Table.Cell(row, col).Merge(Table.Cell(row, col2))
安全规范
- 操作前务必检查对象是否存在:
if (!doc) return "无活动文档";
- 大范围操作用 try/catch 包裹
- 不要假设文档中有特定内容，先检查再操作
- 替换选区前确认 Selection.Text 不为空
claude-office-skills