カスタムテーマ

ビューアをアプリに合わせてスタイル設定

ビューアは埋め込みリソース(viewer.css、および searchBar.css や annotationBar.css のような機能別スタイルシート)から提供される中立的な Bootstrap ベースの外観で提供されます。テーマ設定は 3 つのレベルで行われます — 最も浅いレベルで目的を達成してください。

レベル 1 — クロームの設定

多くの「テーマ設定」は実際には構成です:

  • ViewerConfig.ShowThumbs = false — サムネイルパネルなし。
  • ViewerConfig.FitType = "height" | "width" — ページがビューポートにどのようにフィットするか。
  • 選択的 CssConfig/ScriptConfig バンドル — ホストが使用するクロームだけを保持します。

レベル 2 — CSS のオーバーライド

Viewer.ReferenceCss() はプレーンな <link> タグを出力します;それらの 後 に読み込むものがカスケードで優先されます。独自のスタイルシートでビューアのサイズとフレームを設定してください:

css
/* ReferenceCss() の後に読み込まれるあなたのスタイルシート */

/* あなたが所有する2つのコンテナ */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* Widget ページカード */
.docPage { max-width: none; }

ホストページは外部レイアウトを完全に制御します — ウィジェットは #divDocViewer / #div_ctlDoc が提供する任意のボックス内にレンダリングされます(クイックスタートの標準コンテナペア)。

実用的なルールが 2 つあります:

  • Bootstrap を二重にロードしないでください。 アプリがすでに Bootstrap を提供している場合、IncludeBootstrapCss/IncludeBootstrap をスキップし、ウィジェットにあなたのものを継承させてください — これだけでビューアがアプリにネイティブに見えます。
  • 使用するバンドルだけを含めてください。 すべての CssConfig/ScriptConfig フラグはオプトインです;バンドルが少なければ少ないほど、対処すべきスタイルも減ります。

レベル 3 — 独自のツールバーを構築

完全にブランド化された体験のために、ウィジェットを独自の UI から操作します。そのようなツールバーはホストのマークアップとアプリ固有のヘルパーから構成され、埋め込み SDK リボンではありません。初期化で返される docViewer インスタンスは API のインターフェースであり、独自のエンドポイントと共に使用します:

html
<div id="toolbar">
    <button id="btnOpen">Open</button>
    <button id="btnPrev">‹</button>
    <button id="btnNext">›</button>
    <!-- あなたのデザインシステム、あなたのアイコン -->
</div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
    const objViewer = $('#div_ctlDoc').docViewer({
        showThumbs: true,
        autoLoad:   false,
        BasePath:   '/',
        ResPath:    'doconut-res/images',
        onViewerReady: () => { /* あなたのボタンを有効にする */ },
        onError: (msg) => console.error('DocViewer:', msg)
    });

    document.getElementById('btnOpen').addEventListener('click', async () => {
        const resp  = await fetch('/api/open?fileName=Sample.pdf', { method: 'POST' });
        const token = await resp.text();
        objViewer.View(token);
    });
</script>

Search と Annotation は異なります:それらのオプションの Ribbon コンポーネントは SDK(IncludeSearchBar、IncludeAnnotationBar)に埋め込まれ、独自の DOM を生成します。これらをカスタム Viewer ツールバーと共に使用することも、スキップして基礎となるウィジェット API を直接呼び出すこともできます。完全な統合手順については、クイックスタートの完全な Viewer パッケージ を参照してください。

ダークモードと RTL

ウィジェットにはダークテーマが同梱されていません;背景やボーダーに対してダークモードクラス(例:.dark #divDocViewer { … })を対象としたレベル 2 のオーバーライドを行うことで、ほとんどの要件を満たすことができます。ページコンテンツ自体は画像としてレンダリングされるためです。RTL ホストの場合、ビューアは RTL レイアウト内で問題なく動作します — 独自のツールバーも RTL に対応させてください。

やってはいけないこと

埋め込みスタイルシートをフォークしたり編集したりしないでください:それらはパッケージ内に同梱されており、更新のたびに置き換えられます。独自のスタイルシートでのオーバーライドはアップグレード後も残りますが、viewer.css の編集は残りません。

このページは役に立ちましたか?