Office 加载项中的 Word JavaScript 对象模型

本文介绍了使用 Word JavaScript API 生成加载项的基础概念。

重要

请参阅使用特定于应用程序的 API 模型,以了解 Word API 的异步性质以及它们如何与文档协同工作。

适用于 Word 的 Office.js API

Word加载项使用 Office JavaScript API 与 Word 中的对象进行交互。 这包括两个 JavaScript 对象模型:

  • Word JavaScript APIWord JavaScript API 提供适用于文档、范围、表、列表、格式等的强类型对象。

  • 通用 API通用 API 允许访问多个 Office 应用程序中常见的 UI、对话框和客户端设置等功能。

你可能会使用 Word JavaScript API 开发面向 Word 的加载项中的大部分功能,同时还可以使用通用 API 中的对象。 例如:

  • Office.Context:对象 Context 表示外接程序的运行时环境,并提供对 API 的关键对象的访问。 它由文档配置详细信息(如 contentLanguageofficeTheme)组成,并提供有关加载项的运行时环境(如 hostplatform)的信息。 此外,它还提供了 requirements.isSetSupported() 方法,可用于检查运行加载项的 Word 应用程序是否支持指定的要求集。
  • Office.Document:对象Office.Document提供 getFileAsync() 方法,可用于下载运行加载项的 Word 文件。 这与Word不同。文档对象。

Word JS API 和通用 API 之间的差异。

特定于 Word 的对象模型

若要了解 Word API,则必须了解文档的各个组件之间如何相互关联。

  • Document 包含 Section 以及设置和自定义 XML 部件等文档级实体。
  • Section 包含 Body
  • 通过 Body 可以访问 ParagraphContentControlRange 等对象。
  • Range 表示连续的内容区域,包括文本、空白区域、Table 和图像。 此外,它还包含大部分文本操作方法。
  • List 表示带标号或项目符号的列表中的文本。

另请参阅