ViewerConfig

ViewerConfig（名前空間 Doconut）は、ブラウザビューアの外観と動作を記述します。ドキュメントのレンダリング品質には影響しません；そのためにはフォーマット設定を使用してください。C# クラスと長年使用されている JavaScript ウィジェットはデフォルトが異なるため、値を明示的にマッピングしてください。

C# プロパティ

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // no leading '/': the viewer adds it ("/doconut" would become //doconut, another host)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

C# から JavaScript へのマッピング

シリアライズした ViewerConfig を直接 docViewer(...) に渡さないでください。ほとんどのウィジェットキーは camelCase ですが、3 つの確立されたパス/フィットキーは PascalCase です。

JavaScript のデフォルト

このウィジェットには、C# クラスとは異なる古いデフォルトがあります。以下の値は現在の docViewer.js 実装から取得したものです。

デフォルトのいずれかに依存せず、動作上重要なすべての値を明示的に設定してください：

<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
const objViewer = $('#div_ctlDoc').docViewer({
    showThumbs: true,
    autoLoad: false,
    autoFocus: true,
    autoPageFocus: true,
    pageZoom: 100,
    zoomStep: 10,
    maxZoom: 300,
    FitType: 'width',
    cacheEnabled: false,
    largeDoc: false,
    showHyperlinks: true,
    fixedZoom: true,
    fixedZoomPercent: 100,
    fixedZoomPercentMobile: 75,
    BasePath: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

コールバック

コールバックは高速に保ち、テレメトリは非同期で送信し、ページのレンダリングをブロックしないでください。

パブリックメソッドグループ

JavaScript ファイルには内部ヘルパーも含まれています。参照 UI が使用し、ここまたは機能ガイドで文書化されているメソッドのみを安定した統合ポイントとして扱ってください。

分散ページがまだレンダリング中の間にリトライ

retryOn409 はその歴史的な名前を保持しています。非同期ページ生成のためのもので、現在の 202 Accepted の準備応答と、以前の 409 Conflict シグナルの両方をリトライします。有効にすると、ウィジェットはこれらの JavaScript デフォルトでポーリングします。

通常のビューアでは無効のままにしてください。有効化しても、サポートされていない同期レンダリングを非同期に変えることはできません。

パスチェックリスト

• DoconutOptions.MiddlewarePath は実際にマッピングするブランチを記述する必要があります。
• BasePath はそのブランチを対象とし、先頭の / を付けずに記述する必要があります（'doconut'、'/doconut' ではなく：ビューアがスラッシュを追加し、//doconut/... は別ホストへのリクエストになります）。
• DoconutOptions.ResourcesPath は埋め込みリソースのルートです。
• ResPath は通常、その images サブフォルダを対象とし、先頭の / を付けません（'doconut-res/images'）。
• ExtractHyperlinks は showHyperlinks が何かを表示できるようになる前に、サーバーのフォーマット設定で有効にする必要があります。