概述

插件和宏可以通过 Asc.plugin 对象与编辑器进行交互——其事件、方法和命令。在此您将了解如何使用它们。

• Asc.plugin — 主插件对象：属性、方法和事件
• 如何绑定事件 — 监听编辑器事件
• 如何调用方法
• 如何调用命令

插件的主代码放在一个 .js 文件中，该文件描述了插件应执行的内容以及如何执行。此文件与 config.json 和 index.html 文件一起放置于插件根目录中。

工作原理

任何插件都包含 Asc.plugin 对象，该对象提供与 ONLYOFFICE 文档、电子表格、演示文稿和 PDF 编辑器交互的方法和事件。

备注

请注意，从 7.1 版本开始，由于插件脚本启用了”使用严格模式”，因此在插件命令代码中访问窗口和文件对象以及使用警告函数将受到限制。请务必在使用变量前先声明，以确保插件正常运行。

为了使插件正常运行，开发者必须为 Asc.plugin 对象指定两个必要事件：init 和 button。之后：

• callCommand 用于在一次调用中执行多个 Office JavaScript API 命令。
• executeMethod 用于运行单个编辑器方法（如 AddComment、GetSelectedText）。

如果插件涉及 OLE 对象的操作，使用 callCommand 进行处理。

有关最简工作示例，请参阅 Asc.plugin 页面；有关完整操作指南，请参阅入门指南。更多开源插件示例可在此处查看。