WPS 加载项开发说明

最新推荐文章于 2025-10-10 07:54:41 发布

原创

最新推荐文章于 2025-10-10 07:54:41 发布 · 5.2k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#javascript

本文介绍了WPS加载项的结构和开发流程，包括自定义功能区和网页两部分。详细讲解了启动流程、API使用、调试方法以及两种部署模式：publish模式和jsplugins.xml模式。publish模式适用于无需二次打包，而jsplugins.xml模式适合需要定制加载项的场景。

WPS 加载项结构

WPS 加载项由自定义功能区和网页两部分组成。自定义功能区只需要一个配置文件，对应 WPS 加载项目录中的ribbon.xml文件；网页部分负责执行自定义功能区对应的逻辑功能。因为不需要显示网页，所以省略了 HTML 文件，并用main.js来引入所有的外部 JavaScript 文件；在这些 JavaScript 文件中通常包含了一系列用 JavaScript 实现的函数，这些函数与自定义功能区的功能一一对应，我们称之为接口函数。

启动流程

WPS 加载项启动时，首先在 WPS 加载项对应文件夹中自动创建index.html网页并打开，index.html从当前路径引入main.js，从而能够在接下来的过程中执行接口函数。当网页打开成功之后，开始解析ribbon.xml生成自定义功能区，解析过程中会调用若干次接口函数，最终完成加载。注意，开发者应当避免在该目录下创建index.html。

WPS 加载项 API 使用