PDFビューワは、Acrobatと同様に、PDFの開き方（Initial View）の設定に基づいてPDFドキュメントを開くことができます。開き方設定は、PDFビューワで開いたときに初期設定としてPDFドキュメントをどのように表示するかを指定します。PDFビューワのクライアントサイドのAPIが提供するviewerPreferences タイプを使用して、openAction、pageMode、pageLayout など、PDFドキュメントに定義された開き方設定に関する情報を取得することができます。

PDFビューワのviewerPreferencesプロパティにて、ユーザが設定した開き方設定の情報を取得することができます。次のサンプルコードは、その方法を示しています。

var viewerPreferences = await viewer.viewerPreferences;

次の表は、viewerPreferences を使用して取得できる設定の一覧です。

次のサンプルコードは、ドキュメントを開く際に実行されるアクションの情報を取得する方法を示しています。

var viewerPreferences = await viewer.viewerPreferences;
var openAction = viewerPreferences.openAction;

次のサンプルコードは、ドキュメントを開く際に実行されるアクションから、開くページのインデックスを取得する方法を示しています。

// ドキュメントを開く際に実行されるアクションから、開くページのインデックスを取得します
const openAction = await viewer.openAction;
if(openAction && openAction.dest) {
  const pageRef = openAction.dest[0];
        const targetPageIndex = await viewer.resolvePageIndex(pageRef);
}

次のサンプルコードは、ドキュメントを開く際に使用されるページモードの情報を取得する方法を示しています。

var viewerPreferences = await viewer.viewerPreferences;
var pageMode = viewerPreferences.pageMode;

次のサンプルコードは、ドキュメントを開く際に使用されるページレイアウトの情報を取得する方法を示しています。

var viewerPreferences = await viewer.viewerPreferences;
var pageLayout = viewerPreferences.pageLayout;

PDFビューワにて、PDFドキュメントで指定された開き方設定を使用せずにPDFドキュメントを読み込みたい場合、ignoreInitialView オプションを使用します。次のサンプルコードは、開き方設定を無視する方法を示しています。

var viewer = new DsPdfViewer("#root", { ignoreInitialView: true } );

制限事項

現在、PDFビューワでは、以下の設定はサポートされていません。