更新记录

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)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android: android.permission.INTERNET,用于下载 PDF 文件

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

License

Copyright (c) 2026

本插件为作者自用插件。未经作者明确许可,不得复制、分发、转售、再授权或用于公开商业分发。

如需在团队、客户项目或其他非个人项目中使用,请先获得作者授权。

暂无用户评论。