Microsoft Office

Microsoft Office 是 Microsoft 用于创建和处理文档、电子表格、演示文稿及其他 Office 文件的生产力套件。Protocol Launcher 可以生成官方 Office URI Scheme 链接。

使用方式

有两种使用此库的方式：

• 按需导入（On-Demand）：从子路径导入支持 tree-shaking，保持较小的打包体积。
• 完整导入（Full Import）：从根包导入更方便，但会包含所有应用模块。

生产构建建议选择按需导入；快速脚本或演示可以使用完整导入。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

说明

Microsoft 文档记录了这些 scheme 名称：ms-word、ms-powerpoint、ms-excel、ms-visio、ms-access、ms-project、ms-publisher、ms-spd 和 ms-infopath。

完整命令格式为 scheme:command|descriptor|argument。这些 helper 会原样保留文档和模板 URI 字符串，包括 Microsoft 定义为命令参数数据的 : 和 / 字符。SharePoint Designer 和 InfoPath 的 app launcher 不暴露 newFromTemplate，因为 Microsoft 没有为这两个 scheme 记录 nft 命令。

文档和模板参数必须是有效的 http 或 https URI。helper 也会执行 Microsoft 记录的 Office 2013 command-argument 限制：path 长度最多 256 个字符，Excel 为 216 个字符，path 中的文件名不能包含 \ / : ? < > | " *。为 newFromTemplate 提供 saveLocation 时，Microsoft 要求它与模板 URI 指向同一个 host name。

Open Document

需要让 Office 应用以查看方式打开资源时，可以使用缩写 schema。

On-Demand

import { openDocument } from 'protocol-launcher/microsoft-office'

const url = openDocument({
  scheme: 'ms-word',
  uri: 'https://contoso.com/documents/report.docx',
})

打开 Word 文档

Open For Edit

On-Demand

import { openForEdit } from 'protocol-launcher/microsoft-office'

const url = openForEdit({
  scheme: 'ms-word',
  uri: 'https://contoso.com/documents/report.docx',
})

编辑 Word 文档

Open For View

On-Demand

import { openForView } from 'protocol-launcher/microsoft-office'

const url = openForView({
  scheme: 'ms-excel',
  uri: 'https://contoso.com/Q4/budget.xlsx',
})

查看 Excel 工作簿

New From Template

On-Demand

import { newFromTemplate } from 'protocol-launcher/microsoft-office'

const url = newFromTemplate({
  scheme: 'ms-powerpoint',
  templateUri: 'https://contoso.com/templates/status.potx',
  saveLocation: 'https://contoso.com/presentations/',
})

从模板创建 PowerPoint

App Launchers

目标 Office 应用已知时，可以使用 app launcher。

On-Demand

import { word, powerPoint } from 'protocol-launcher/microsoft-office'

const editWordUrl = word.openForEdit({
  uri: 'https://contoso.com/documents/report.docx',
})

const newDeckUrl = powerPoint.newFromTemplate({
  templateUri: 'https://contoso.com/templates/status.potx',
  saveLocation: 'https://contoso.com/presentations/',
})

包中还导出 excel、visio、access、project、publisher、sharePointDesigner 和 infoPath launcher。

生成的 URL

openDocument(openDocumentParams)
// => 'ms-word:https://contoso.com/documents/report.docx'

openForEdit(openForEditParams)
// => 'ms-word:ofe|u|https://contoso.com/documents/report.docx'

openForView(openForViewParams)
// => 'ms-excel:ofv|u|https://contoso.com/Q4/budget.xlsx'

newFromTemplate(newFromTemplateParams)
// => 'ms-powerpoint:nft|u|https://contoso.com/templates/status.potx|s|https://contoso.com/presentations/'

word.openForEdit(wordDocumentParams)
// => 'ms-word:ofe|u|https://contoso.com/documents/report.docx'

powerPoint.newFromTemplate(powerPointTemplateParams)
// => 'ms-powerpoint:nft|u|https://contoso.com/templates/status.potx|s|https://contoso.com/presentations/'

参考资料

• Office URI Schemes