指南
如何在 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- 监听 load、pageChange、error、close 和 linkTap 事件。
使用示例
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();
完整参考文档
- GitHub: https://github.com/Cap-go/capacitor-pdf-viewer/
- 文档: /docs/plugins/pdf-viewer/