使用 Script Lab 探索 Office JavaScript API

Script Lab 是任何人都可以学习如何开发 Office 加载项的免费工具。Script Lab 允许你在 Excel、Outlook、PowerPoint 和 Word 中与文档一起编写和运行 Office JavaScript API。 使用此方便的工具制作原型并验证你自己加载项中所需的功能。

在这个一分钟的 YouTube 视频中查看 Script Lab 的实际应用。 展示 Script Lab 在 Excel、Word 和 PowerPoint 中运行的预览视频。

什么是 Script Lab?

Script Lab 是用于原型化加载项的加载项。它在 Excel、Outlook、PowerPoint、Word 中使用 Office JavaScript API,并位于文档、电子表格或电子邮件内的任务窗格中。 它有一个支持 IntelliSense 的代码编辑器,建立在 Visual Studio Code 使用的相同框架之上。 通过 Script Lab,您可以访问示例库。 快速试用功能,或将这些示例用作你自己的代码的起点。 您甚至可以尝试 Script Lab 中即将推出的仍处于预览阶段的 API。

注意

Script Lab 与 Office 脚本无关。 Office 脚本 是用于在 Excel 中实现最终用户自动化的工具。 如果需要快速、可重用且不需要与 Web 服务集成的解决方案,请使用 Office 脚本。

关键功能

Script Lab 提供了许多功能来帮助你制作加载项功能原型和浏览 Office JavaScript API。

浏览示例

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

示例。

代码和样式

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

预览 API

若要在代码片段中调用预览 API,需要更新代码片段的库,以使用 Beta 版内容分发网络 (CDN) (https://officeapis.public.onecdn.static.microsoft/beta/office.js) 和预览类型定义 @types/office-js-preview。 此外,仅当已注册 Microsoft 365 预览体验计划 并运行 Office 预览体验成员版本时,才能访问某些预览 API。

保存和共享代码段

默认情况下,在 Script Lab 中打开的代码片段将保存到浏览器缓存或本地存储中。 若要永久保存代码片段,请选择 “复制 ”,并将生成的剪贴板内容粘贴到新的.yml文件中。 使用它与同事共享代码段或为社区网站(如 Stack Overflow)提供代码。

若要将代码片段导入 Script Lab,请从菜单中选择 导入 并粘贴代码片段的完整 YAML。 如果已将 YAML 另存为 GitHub Gist,则可以改为粘贴指向 Gist 的链接。

支持的客户端

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

  • Office 网页版
  • Windows 版 Office
  • Mac 版 Office

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

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

限制

Script Lab 旨在让您玩小代码示例。 一般来说,一个代码段最多应为几百行和几千个字符。

代码段可以使用硬编码数据。 少量数据 (比如说,几百个字符) 就可以在 Script Lab 中硬编码。 但是,对于较大的数据片段,我们建议您将这些数据片段存储在外部,然后在运行时使用类似 fetch以下命令加载它们。

将代码片段和硬编码数据保持较小,因为存储多个大型代码片段可能会超出 Script Lab 的存储空间,并在加载 Script Lab 时导致问题。

后续步骤

在 Script Lab 中制作代码原型后,按照“从Script Lab代码创建独立 Office 加载项”中的步骤将其转换为实际的加载项。

问题

如果发现问题或有反馈,请告诉我们!

另请参阅