如何使用 wx.openDocument 打开文档？

推荐答案

// www.javascriptcn.com code example
wx.downloadFile({
  url: 'https://example.com/sample.pdf', // 文档的下载地址
  success: function (res) {
    const filePath = res.tempFilePath;
    wx.openDocument({
      filePath: filePath,
      fileType: 'pdf', // 文件类型，支持 pdf、doc、xls、ppt 等
      success: function (res) {
        console.log('打开文档成功');
      },
      fail: function (err) {
        console.error('打开文档失败', err);
      }
    });
  },
  fail: function (err) {
    console.error('下载文件失败', err);
  }
});

本题详细解读

1. wx.downloadFile 的作用

wx.downloadFile 是微信小程序中用于下载文件的 API。它可以将远程文件下载到本地临时路径，并返回文件的临时路径 tempFilePath。这个临时路径可以用于后续的文件操作。

2. wx.openDocument 的作用

wx.openDocument 是微信小程序中用于打开文档的 API。它支持打开多种类型的文档，如 PDF、Word、Excel、PPT 等。通过传入文件的临时路径和文件类型，可以在小程序中直接打开并查看文档内容。

3. 参数说明

• url: 需要下载的文件的远程地址。
• filePath: 文件的临时路径，通常由 wx.downloadFile 返回。
• fileType: 文件的类型，支持 pdf、doc、xls、ppt 等。

4. 使用场景

wx.openDocument 通常用于需要在小程序中展示或查看文档的场景，如查看合同、报告、表格等。通过结合 wx.downloadFile，可以实现从远程服务器下载文档并在小程序中打开的功能。

5. 注意事项

• 下载的文件路径是临时的，小程序关闭后会被清理。
• 文件类型必须与文件的实际类型一致，否则可能导致打开失败。
• 需要在小程序的 app.json 中配置 downloadFile 和 openDocument 的合法域名。