更新记录

0.1.0（2026-03-29）

• 新增 view-pdf 原生组件，支持 App 内 PDF 查看
• 新增 mode 配置：paged 分页翻页 / scroll 全文滚动
• 新增 quality（清晰度）与 zoom（放大倍率）配置
• 支持远程 PDF 下载后本地渲染示例

平台兼容性

view-pdf（uni-app x）

view-pdf 是一个 uni-app x App 端原生 PDF 组件，用于在页面内展示 PDF。

功能特性

• 支持 paged 分页查看
• 支持 scroll 全文滚动查看
• 支持 quality 清晰度调节
• 支持 zoom 缩放倍率调节

安装

将插件目录放入项目：

• uni_modules/view-pdf

基础示例

<template>
  <view class="page">
    <view-pdf class="viewer" :url="pdfPath" :quality="3" :zoom="1.4" mode="scroll" />
  </view>
</template>

<script setup lang="uts">
import { ref } from 'vue'

const pdfPath = ref('')

uni.downloadFile({
  url: 'https://applet-ui20s.ulike.com/app/video/skin-test.pdf',
  success: (res) => {
    if (res.statusCode == 200 && res.tempFilePath.length > 0) {
      pdfPath.value = res.tempFilePath
    }
  }
})
</script>

<style>
.page {
  flex: 1;
}

.viewer {
  flex: 1;
}
</style>

属性

• url: string PDF 路径（建议传本地路径）
• quality: number 清晰度倍率，默认 2，范围 1~4
• zoom: number 缩放倍率，默认 1，范围 1~4
• mode: string 查看模式：paged / scroll

事件

• load：加载成功
• error：加载失败

说明

• 网络 PDF 建议先下载为本地临时文件后再传入。
• 若出现空白，优先检查组件容器是否有有效高度。