更新记录

1.0.1（2026-03-31）

1.优化界面

1.0.0（2026-03-31）

1.安卓和iOS发布

平台兼容性

uni-app(4.19)

why-file-reader 文档预览插件

App 端文档预览插件，支持本地/远程文件预览、水印、自定义导航栏、截屏控制，缓存大小和清理缓存。

快速开始

import { openDocumentPreview } from "@/uni_modules/why-file-reader"

openDocumentPreview({
  path: 'https://example.com/test.pdf',
  fileName: '企业介绍.pdf',
  fileType: 'pdf',
  allowScreenshot: false,
  navigationBar: {
    titleColor: '#FFFFFF',
    gradientStartColor: '#009144',
    gradientEndColor: '#005BAC'
  },
  watermark: {
    showText: '水印名称',
    size: 14,
    degree: 30,
    transparent: 55,
    color: '#b8b7b7',
    spacingX: 25,
    spacingY: 55
  },
  onPreviewSuccess: (res) => {
        console.log('预览成功==',res)
  },
  onPreviewExit: (res) => {
        console.log('退出预览==',res)
  }
})

参数说明

openDocumentPreview(options)

navigationBar

同时传 gradientStartColor 和 gradientEndColor 时优先使用渐变背景，否则使用 backgroundColor。

watermark

缓存管理

插件预览远程文件时会自动下载到本地缓存，提供以下两个方法管理缓存。

getPreviewCacheSize(callback)

获取预览缓存总大小，单位 MB。

import { getPreviewCacheSize } from "@/uni_modules/why-file-reader"

getPreviewCacheSize((res) => {
  console.log(`缓存大小：${res.size} MB`)  // 例如 12.35
})

clearPreviewCache(callback)

清理所有预览缓存文件。

import { clearPreviewCache } from "@/uni_modules/why-file-reader"

clearPreviewCache((res) => {
  console.log(res.errMsg)  // clearPreviewCache:ok
})

注意事项

• 建议始终传 fileName 和 fileType，避免远程地址识别不准
• allowScreenshot 默认 false，需要截屏请显式传 true
• 水印至少需要传 showText
• 记录预览时间，可在两个回调中处理
• 问题联系Q：1-0-7-2-8-1-0-1-6-4