使用 Script Lab 探索 Office JavaScript API

Script Lab是一种免费工具,可供任何人了解如何开发 Office 加载项。Script Lab允许在 Excel、Outlook、PowerPoint 和 Word 中将 Office JavaScript API 与文档一起编写和运行。 使用此便捷工具在自己的外接程序中对所需的功能进行原型制作和验证。

观看这一分钟 YouTube 视频中的Script Lab。 预览视频,其中显示了在 Excel、Word 和 PowerPoint 中运行的Script Lab。

什么是 Script Lab?

Script Lab是用于创建外接程序原型的加载项。它使用 Excel、Outlook、Word 和 PowerPoint 中的 Office JavaScript API,位于文档、电子表格或电子邮件内的任务窗格中。 它具有一个支持 IntelliSense 的代码编辑器,该编辑器基于 Visual Studio Code 使用的同一框架构建。 通过Script Lab,可以访问示例库以快速试用功能或将这些示例用作你自己的代码的起点。 甚至可以在仍以开发人员预览版提供Script Lab中尝试即将推出的 API。

关键功能

Script Lab 提供许多功能,可帮助你探索 Office JavaScript API 和原型加载项功能。

浏览示例

通过一系列展示如何使用 API 完成任务的内置示例快速入门。 可以运行示例来立即查看任务窗格或文档中的结果,检查示例来了解 API 的工作原理,甚至可以使用示例来构建自己的加载项的原型。

样品。

代码和样式

除了用于调用 Office JS API 的 JavaScript 或 TypeScript 代码之外,每个代码段还包含用于定义任务窗格内容的 HTML 标记和用于定义任务窗格外观的 CSS。 在为自己的加载项确定任务窗格设计原型时,可以自定义该 HTML 标记 和 CSS,对元素放置和样式设计进行试验。

提示

若要在代码段内调用预览 API,需要更新代码段的库,以使用 beta 内容交付网络 (CDN)(https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) 和预览类型定义@types/office-js-preview。 此外,仅当注册 Office 预览体验计划后、运行 Office 预览体验计划版本时,才能访问某些预览 API。

保存和共享代码段

默认情况下,在 Script Lab 中打开的代码段将保存到浏览器缓存中。 若要永久保存代码段,可将其导出到 GitHub gist。 可创建机密 gist 来保存自己专用的代码段,或创建公用 gist 以便与他人共享。

共享选项。

导入代码段

可通过指定存用于储代码段 YAML 的公共 GitHub gist URL,或通过在代码段的完整 YAML 中粘贴,将代码段导入到 Script Lab。 当其他人通过发布到 GitHub gist 或提供 YAML 来与你共享其代码段时,此功能可能很有用。

导入代码段选项。

支持的客户端

以下客户端上的 Excel、Word 和 PowerPoint 支持 Script Lab。

  • Windows 上的 Office*
  • Mac 版 Office
  • Office 网页版

适用于 Outlook 的 Script Lab 在以下客户端上可用。

  • Windows 版 Outlook*
  • Mac 版 Outlook
  • 使用 Chrome、Microsoft Edge 或 Safari 浏览器时的 Outlook 网页版

有关适用于 Outlook 的 Script Lab 的更多详细信息,请参阅相关博客文章

重要

* Script Lab不再适用于使用 Internet Explorer 托管加载项的平台和 Office 版本的组合。这包括 Office 到 Office 2019 的永久版本。 有关详细信息,请参阅 Office 加载项使用的浏览器

后续步骤

若要在 Excel、Word 或 PowerPoint 中使用 Script Lab,请从 AppSource 安装 Script Lab 加载项

若要使用适用于 Outlook 的 Script Lab,请从 AppSource 安装 适用于 Outlook 的 Script Lab 加载项

欢迎将新代码段发布到 office-js-snippets GitHub 存储库,以扩充 Script Lab 中的示例库。

准备好创建你的首个 Office 加载项时,请尝试使用 ExcelOutlookWordOneNotePowerPointProject 快速入门。

另请参阅