メインコンテンツへスキップ
@capgo/capacitor-pdf-viewer ファイルとストレージ オープンソース

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 - 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();

リファレンス全文

よくある質問

PDF Viewer プラグイン FAQ

Capacitor アプリに PDF Viewer プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-pdf-viewer"(または "npm install @capgo/capacitor-pdf-viewer")を実行し、続けて "bunx cap sync" を実行して、iOS と Android プロジェクトにネイティブの code を反映させてください。アプリの code で "@capgo/capacitor-pdf-viewer" からインポートします。

@capgo/capacitor-pdf-viewer は React、Vue、Angular で動作しますか?

はい。PDF ViewerはCapacitorパッケージなので、Ionic、React、Vue、Angular、Svelte、素のJavaScriptなど、Capacitor上で動作するあらゆるWebフレームワークに対応しています。

@capgo/capacitor-pdf-viewerはどのバージョンのCapacitorをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-pdf-viewerは無料でオープンソースですか?

はい。codeはGitHub上の https://github.com/Cap-go/capacitor-pdf-viewer/ で公開されており、パッケージはnpmから無料でインストールできます。バグ報告やプルリクエストも歓迎します。

App Storeの審査を通さずに、PDF Viewerを使っているcodeをアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずにPDF Viewerの変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める