Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

IDRViewer JavaScript API

IDRViewerは、UIを簡単に構築できるシンプルな表示コンポーネントとして設計されています。ページの読み込み、ズーム、ページの表示・レイアウトなど、複雑な処理をすべて担い、ビューアーを操作するためのシンプルなAPIを提供します。いくつかのUIサンプルが用意されており、そのまま利用することも、独自のユーザーインターフェースを構築する際の出発点や参考例として活用することもできます。

ビューアー API:

ナビゲーション:

  • IDRViewer.next(); - 次のページへ移動
  • IDRViewer.prev(); - 前のページへ移動
  • IDRViewer.goToPage(page); - 指定したページへ移動

ズーム:

  • IDRViewer.zoomIn(); - ドキュメントをズームイン
  • IDRViewer.zoomOut(); - ドキュメントをズームアウト
  • IDRViewer.setZoom(IDRViewer.ZOOM_AUTO); - ブラウザに最適なサイズに自動ズーム(ドキュメントとレイアウトモードに依存)
  • IDRViewer.setZoom(IDRViewer.ZOOM_ACTUALSIZE); - ドキュメントを100%に拡大
  • IDRViewer.setZoom(IDRViewer.ZOOM_FITWIDTH); - 幅に合わせてズーム(連続モードでは最大のページ幅を使用)
  • IDRViewer.setZoom(IDRViewer.ZOOM_FITHEIGHT); - 高さに合わせてズーム(連続モードでは最大のページ高さを使用)
  • IDRViewer.setZoom(IDRViewer.ZOOM_FITPAGE); - ページ全体に合わせてズーム(連続モードでは最大のページを使用)
  • IDRViewer.setZoom(0.5); - 指定したズーム値にドキュメントを拡大・縮小

レイアウト:

  • IDRViewer.setLayout(IDRViewer.LAYOUT_CONTINUOUS); - レイアウトを連続モードに設定
  • IDRViewer.setLayout(IDRViewer.LAYOUT_PRESENTATION); - レイアウトをプレゼンテーションモードに設定
  • IDRViewer.setLayout(IDRViewer.LAYOUT_MAGAZINE); - レイアウトをマガジンモードに設定

選択:

  • IDRViewer.setSelectMode(IDRViewer.SELECT_PAN); - 選択モードをマウスパンに設定
  • IDRViewer.setSelectMode(IDRViewer.SELECT_SELECT); - 選択モードをテキスト選択に設定

回転:

  • IDRViewer.setRotation(degrees); - ドキュメントの回転角度を設定。90の倍数である必要があり、それ以外の場合は TypeError がスローされます。
  • IDRViewer.rotate(delta); - 現在の回転角度を基準にドキュメントを相対的に回転。90の倍数である必要があり、それ以外の場合は TypeError がスローされます。

イベント:

ユーザーの操作に応じてUIを更新するために、さまざまなイベントをリッスンできます。イベントリスナーの追加と削除には、IDRViewer.on('eventtype', eventListener); および IDRViewer.off('eventtype', eventListener); を使用します。

使用例:

IDRViewer.on('pagechange', function(data) {
    console.log("navigated to page " + data.page);
});

ready:

  • page (number) - 現在のページ
  • pagecount (number) - ドキュメントの総ページ数
  • bounds (array[[number, number]]) - ページの境界サイズの配列
  • thumbnailType (string) - サムネイルのファイル形式(jpg または png)
  • selectMode (string) - 現在の選択モード
  • isMobile (boolean) - モバイルまたはタブレットでの閲覧かどうか
  • layout (string) - 現在のレイアウトモード
  • availableLayouts (array[string]) - 使用可能なレイアウトの一覧
  • title (string) - 変換されたファイルのタイトル(存在する場合)
  • bookmarks (object) - 変換されたファイルのブックマーク(存在する場合)
  • pageType (string) - ページのファイル形式(html または svg)
  • isFirstPage (boolean) - 現在のページが最初のページかどうか
  • isLastPage (boolean) - 現在のページが最後のページかどうか

pagechange:

  • page (number) - 現在のページ
  • pagecount (number) - ドキュメントの総ページ数
  • isFirstPage (boolean) - 現在のページが最初のページかどうか
  • isLastPage (boolean) - 現在のページが最後のページかどうか

pageload:

  • page (number) - 読み込まれたページ番号

pageunload:

  • page (number) - アンロードされたページ番号

layoutchange:

  • layout (string) - 現在のレイアウトモード

selectchange:

  • type (string) - 現在の選択モード

zoomchange:

  • zoomType (string) - 現在のズームモード
  • scale (number) - 実際のスケール値
  • isMinZoom (boolean) - 現在のズームが最小かどうか
  • isMaxZoom (boolean) - 現在のズームが最大かどうか

rotationchange:

  • rotation (number) - 現在の回転角度(0、90、180、270)

searchready:

引数なし

  • searchTerm (String) - 検索された文字列
  • results (array[object]) - PDF上での検索語と設定に対するすべての検索結果。各結果にはページ番号、ページ内のインデックス、一致したテキストのスニペットが含まれます
  • settings (object(matchCase, limitOnePerPage, decompose snippets)) - 検索に使用された設定

searchresultselected:

  • resultIndex (int) - searchResults 配列内の選択された結果のインデックス
  • result (object) - 配列からプリフェッチされた結果オブジェクト

デフォルト設定:

デフォルト設定を変更するには、setup 関数が呼び出される前にビューアー API を使用します。

使用例:

IDRViewer.goToPage(2); // Set default page
IDRViewer.setZoom(IDRViewer.ZOOM_FITPAGE); // Set default zoom
IDRViewer.setLayout(IDRViewer.LAYOUT_PRESENTATION); // Set default layout
IDRViewer.setSelecMode(IDRViewer.SELECT_SELECT); // Set default select mode
IDRViewer.setRotation(90); // Set the default rotation
IDRViewer.setup(); // Load viewer with new default settings

トランジション:

プレゼンテーションモードおよびマガジンレイアウトモードでは、さまざまなトランジションを利用できます。IDRViewer 要素に対応する CSS クラスを追加することでトランジションを有効化できます。

使用例:

<div id="idrviewer" class="transition-flip"></div>

プレゼンテーションレイアウトのトランジション:

  • transition-flip
  • transition-slide
  • transition-throw
  • transition-fade

マガジンレイアウトのトランジション:

  • transition-magazine