跳过主要内容
@capgo/capacitor-pdf-浏览器 文件和存储 开源

PDF 查看器 Capacitor 插件

在 iOS、Android 和 Web 上嵌入本机 PDF 视图,支持路径、URL、base64、内联模式和密码

安装

bun add @capgo/capacitor-pdf-viewer bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-pdf-viewer
  • pnpm add @capgo/capacitor-pdf-viewer
  • yarn add @capgo/capacitor-pdf-viewer

指南

如何在Capacitor中使用PDF Viewer

使用@capgo/capacitor-pdf-viewer

iOS(PDFKit)、Android(Pdfium)和Web上的原生PDF查看,支持路径、URL、base64和内联模式。

安装

bun add @capgo/capacitor-pdf-viewer
bunx cap sync

此插件暴露了什么

  • open - 从文件、路径、URL或base64源打开PDF。
  • close - 关闭当前查看器并移除任何覆盖层。
  • goToPage - 跳转到1基数的页码。
  • setZoom - 设置缩放比例乘数。
  • getPluginVersion - 获取本机或Web实现版本标记。
  • addListener - 监听加载、页码改变、错误、关闭和链接点击事件。

- 示例用法

open

import { PdfViewer } from '@capgo/capacitor-pdf-viewer';

await PdfViewer.addListener('pageChange', ({ page, pageCount }) => {
  console.log(`Page ${page} of ${pageCount}`);
});

const { pageCount } = await PdfViewer.open({
  source: 'https://example.com/manual.pdf',
  mode: 'fullscreen',
  scrollMode: 'continuous',
  page: 1,
});

console.log(`Opened ${pageCount} pages`);

close

import { PdfViewer } from '@capgo/capacitor-pdf-viewer';

await PdfViewer.close();

- 全部参考

常见问题

PDF Viewer插件常见问题

如何在Capacitor应用中安装PDF Viewer插件?

运行"bun add @capgo/capacitor-pdf-viewer" (或"npm install @capgo/capacitor-pdf-viewer"),然后运行"bunx cap sync"以便iOS和Android项目捕获native code。从"@capgo/capacitor-pdf-viewer"中导入它到你的应用code。

是否@capgo/capacitor-pdf-viewer在React、Vue和Angular中可用?

是的。PDF Viewer是一个Capacitor包,因此它与任何在Capacitor中运行的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

哪个 Capacitor 版本支持 @capgo/capacitor-pdf-viewer?

Capgo 插件遵循 Capacitor 的主要版本:使用与您的 Capacitor 主要版本匹配的插件版本(例如插件 v8 与 Capacitor 8)。兼容性表格在 GitHub README 中列出已维护的版本。

是否支持 @capgo/capacitor-pdf-viewer 免费和开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-pdf-viewer/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在App Store没有审核的情况下更新使用PDF Viewer的 code?

安装或升级插件会改变本机 code,所以需要一个新的商店构建。之后,JavaScript、HTML和CSS调用插件的更改可以立即与 Capgo 实时更新一起发布。

不必等待应用程序审查就可以将 PDF Viewer 的更改推送到用户

一旦插件在您的商店构建中,Capgo 实时更新将推送您的 JavaScript、HTML 和 CSS 更改到用户中几分钟内。

从 Capgo 开始