更新记录
1.0.0(2026-06-14)
下载此版本
- 初始版本。
- 支持 uni-app App Android PDF 预览。
- 支持 uni-app App iOS PDF 预览。
- 支持 PDF 网络下载、缓存和基础清理能力。
平台兼容性
uni-app(4.62)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
app-nvue插件版本 |
Android |
Android插件版本 |
iOS |
iOS插件版本 |
鸿蒙 |
| × |
√ |
× |
× |
- |
√ |
1.0.0 |
6.0 |
1.0.0 |
15 |
1.0.0 |
× |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| × |
× |
× |
× |
× |
× |
× |
× |
× |
× |
× |
× |
hj-pdf-viewer
高性能 PDF 查看器插件
<template>
<view class="container">
<hj-pdf-viewer
:pdfUrl="pdfUrl"
:autoClean="false"
@load="onPdfLoad"
@pageChange="onPageChange"
@error="onError"
style="width: 100%; height: 100vh;"
/>
</view>
</template>
<script>
export default {
data() {
return {
pdfUrl: "https://example.com/sample.pdf",
};
},
methods: {
onPdfLoad(e) {
console.log("PDF 加载完成,总页数:", e.totalPages);
},
onPageChange(e) {
console.log(`当前页: ${e.currentPage + 1}/${e.totalPages}`);
},
onError(e) {
console.error("PDF 加载失败:", e.error);
},
},
};
</script>
📖 API
Props
| 属性 |
类型 |
默认值 |
说明 |
| pdfUrl |
String |
'' |
PDF 文件 URL |
| autoClean |
Boolean |
false |
是否自动清理 |
🔐 安全性
- ✅ PDF 存储在应用私有目录 (
getCacheDir())
- ✅ 使用 MD5 哈希作为文件名,避免路径泄露
- ✅ 支持 HTTPS 下载
- ✅ OkHttp 超时保护(连接:30s,读写:60s)