你想要的PDF预览新方式,微信小程序绝对不容错过

前言

随着微信小程序的不断发展和变革,越来越多的功能被开发出来,其中预览 PDF 文件功能也已经成为小程序的常见应用之一。今天,我们将针对微信小程序预览 PDF 这一功能,为大家详细解析和介绍。


实现思路

  1. 在小程序界面中添加一个按钮,并为其绑定一个点击事件;
  2. 在事件中调用 wx.downloadFile 方法,指定要下载的 pdf 文件的 url 和存储路径;
  3. 下载完成后,再调用 wx.openDocument 方法打开该文件预览。在调用此方法时,需要把之前存储的文件路径传入。

注意: 由于微信小程序的安全限制,必须先调用 wx.downloadFile 方法下载文件,才能在小程序中打开该文件。


wx.downloadFile(Object object)

参数

参数类型是否必填说明
urlstring下载资源的 url
headerObjectHTTP 请求的 Header,Header 中不能设置 Referer
timeoutnumber超时时间,单位为毫秒
filePathstring指定文件下载后存储的路径 (本地路径)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例

wx.downloadFile({
  url: 'https://example.com/audio/123', //仅为示例,并非真实的资源
  success (res) {
    // 只要服务器有响应数据,就会把响应内容写入文件并进入 success 回调,业务需要自行判断是否下载到了想要的内容
    if (res.statusCode === 200) {
      wx.playVoice({
        filePath: res.tempFilePath
      })
    }
  }
})

该方法的完整文档信息大家可以『点击这里』查看。


wx.openDocument(Object object)

参数

参数类型是否必填说明
filePathstring文件路径 (本地路径) ,可通过 downloadFile 获得
showMenuboolean默认值为false,是否显示右上角菜单
fileTypestring文件类型,指定文件类型打开文件
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例

wx.downloadFile({
  // 示例 url,并非真实存在
  url: 'http://example.com/somefile.pdf',
  success: function (res) {
    const filePath = res.tempFilePath
    wx.openDocument({
      filePath: filePath,
      success: function (res) {
        console.log('打开文档成功')
      }
    })
  }
})

该方法的完整文档信息大家可以『点击这里』查看。


实践

看到这里,相信大家对这两个方法已经有了一定的了解,下面我们直接用一个更完整的实例来帮助大家更好的使用该方法实现预览 pdf 的功能。话不多说,下面直接看代码。

wxml 文件

<view>
	<button bindtap="itemPdfOn" type="primary">点我预览</button>
</view>

js 文件

Page({
    // 查看pdf事件方法  
    itemPdfOn() {
        wx.showLoading({
            title: '加载中',
        })
        // 下载文件方法
        wx.downloadFile({
            url: 'https://s30.aconvert.com/convert/p3r68-cdx67/ah4fu-1s24x.pdf',
            success: function (res) {
                var Path = res.tempFilePath //返回的文件临时地址,用于后面打开本地预览所用
                wx.openDocument({
                    filePath: Path,
                    success: function () {
                        console.log("打开文档成功");
                        wx.hideLoading()
                    }
                })
            },
            fail: function (res) {
                console.log(res);
            }
        })
    },
})

实现效果

在这里插入图片描述

### 如何在 UniApp 微信小程序中实现 PDF 文件预览 为了实现在 UniApp 中的微信小程序预览 PDF 文件的功能,可以采用 `web-view` 组件加载在线 PDF 查看器的方式。这种方式能够很好地适配不同类型的设备并提供较为流畅的用户体验。 对于直接通过 URL 访问 PDF 文件的情况,在 web-view 中可以直接指定该 URL 进行展示[^1]: ```html <template> <view> <!-- 使用 web-view 加载 pdf --> <web-view :src="pdfUrl"></web-view> </view> </template> <script> export default { data() { return { pdfUrl: 'https://example.com/path/to/your/document.pdf' // 替换成实际的PDF链接 }; } }; </script> ``` 然而当遇到经过代理服务器处理后的请求时(即URL不以`.pdf`结尾),可能会导致部分平台无法正常解析文档内容而出现白屏现象。针对这一情况,建议使用 PDF.js 来解决跨平台兼容性问题,并且还可以借此机会加入更多定制化特性比如添加水印等[^2]。 具体做法如下所示: #### 安装依赖库 首先需要引入 PDF.js 库到项目当中去。可以通过 npm 或者手动下载的形式完成安装操作。这里推荐利用 npm 方式来进行管理以便于后续维护升级工作更加便捷高效。 ```bash npm install pdfjs-dist --save ``` 接着确保已将字体资源也一并打包进来以免发生渲染异常状况: ```javascript import * as pdfjsLib from "pdfjs-dist"; // 导入worker脚本 import { Worker } from "pdfjs-dist/build/pdf.worker.entry"; pdfjsLib.GlobalWorkerOptions.workerSrc = Worker; ``` #### 编写页面逻辑 创建一个的 Vue 页面用于呈现 PDF 文档视图。在此基础上编写相应的 JavaScript 方法来获取远程文件流数据并通过 canvas 元素绘制每一页的内容图像。 ```html <template> <scroll-view scroll-y class="container"> <canvas v-for="(page, index) in pages" :key="index" :id="'pdf-page-' + (index + 1)" style="width: 100%; height: auto;"></canvas> </scroll-view> </template> <script> import * as pdfjsLib from "pdfjs-dist"; import { getDocument } from "pdfjs-dist"; export default { onLoad(options) { this.loadPdf(options.url); }, methods: { async loadPdf(url) { const loadingTask = getDocument({ url }); const pdf = await loadingTask.promise; let totalPages = pdf.numPages; for (let pageNumber = 1; pageNumber <= totalPages; pageNumber++) { try { const page = await pdf.getPage(pageNumber); const viewport = page.getViewport({ scale: window.innerWidth / page.view[2] }); const canvasId = '#pdf-page-' + pageNumber; const query = uni.createSelectorQuery().in(this.$scope); query.select(canvasId).fields({ node: true, size: true }, res => { if (!res || !res.node) return; const canvas = res.node; const ctx = canvas.getContext('2d'); const renderContext = { canvasContext: ctx, viewport: viewport }; page.render(renderContext); }).exec(); } catch (error) { console.error(`Failed to fetch or render page ${pageNumber}`, error); } } this.pages = Array.from({ length: totalPages }, (_, i) => i + 1); } }, data() { return { pages: [] }; } } </script> <style scoped> .container { padding-top: 20rpx; } /* 添加一些样式调整 */ </style> ``` 上述代码实现了基本的 PDF 预览功能,同时也解决了由于路径格式引起的显示错误问题。如果还需要进一步增强应用的安全性和功能性,则可以在原有基础上继续扩展其他插件或服务端接口的支持。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

水星记_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值