Office 加载项中的 Word JavaScript 对象模型
本文介绍了使用 Word JavaScript API 生成加载项的基础概念。
重要
请参阅使用特定于应用程序的 API 模型,以了解 Word API 的异步性质以及它们如何与文档协同工作。
适用于 Word 的 Office.js API
Word加载项使用 Office JavaScript API 与 Word 中的对象进行交互。 这包括两个 JavaScript 对象模型:
Word JavaScript API:Word JavaScript API 提供适用于文档、范围、表、列表、格式等的强类型对象。
通用 API:通用 API 允许访问多个 Office 应用程序中常见的 UI、对话框和客户端设置等功能。
你可能会使用 Word JavaScript API 开发面向 Word 的加载项中的大部分功能,同时还可以使用通用 API 中的对象。 例如:
- Office.Context:对象
Context
表示外接程序的运行时环境,并提供对 API 的关键对象的访问。 它由文档配置详细信息(如contentLanguage
和officeTheme
)组成,并提供有关加载项的运行时环境(如host
和platform
)的信息。 此外,它还提供了requirements.isSetSupported()
方法,可用于检查运行加载项的 Word 应用程序是否支持指定的要求集。 - Office.Document:对象
Office.Document
提供getFileAsync()
方法,可用于下载运行加载项的 Word 文件。 这与Word不同。文档对象。
特定于 Word 的对象模型
若要了解 Word API,则必须了解文档的各个组件之间如何相互关联。
- Document 包含 Section 以及设置和自定义 XML 部件等文档级实体。
- Section 包含 Body。
- 通过 Body 可以访问 Paragraph、ContentControl 和 Range 等对象。
- Range 表示连续的内容区域,包括文本、空白区域、Table 和图像。 此外,它还包含大部分文本操作方法。
- List 表示带标号或项目符号的列表中的文本。