カスタムテーマ
ビューアをアプリに合わせてスタイル設定
ビューアは埋め込みリソース(viewer.css、および searchBar.css や annotationBar.css のような機能別スタイルシート)から提供される中立的な Bootstrap ベースの外観で提供されます。テーマ設定は 3 つのレベルで行われます — 最も浅いレベルを選んで目的を達成してください。
レベル 1 — クロームの設定
多くの「テーマ設定」は実際には構成です:
ViewerConfig.ShowThumbs = false— サムネイルパネルなし。ViewerConfig.FitType = "height" | "width"— ページがビューポートをどのように埋めるか。- 選択的
CssConfig/ScriptConfigバンドル — ホストが使用するクロームだけを保持します。
レベル 2 — CSS の上書き
Viewer.ReferenceCss() はプレーンな <link> タグを出力します;それらの後に読み込むものがカスケードで優先されます。独自のスタイルシートでビューアのサイズとフレームを設定してください:
/* ReferenceCss() の後に読み込まれる、あなたのスタイルシート */
/* あなたが所有する2つのコンテナ */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* ウィジェットページカード */
.docPage { max-width: none; }ホストページは外部レイアウトを完全に制御します — ウィジェットは #divDocViewer / #div_ctlDoc で指定した任意のボックス内に描画されます(クイックスタートからの標準コンテナペア)。
実用的なルールは 2 つです:
- Bootstrap を二重に読み込まないでください。 アプリがすでに Bootstrap を提供している場合、
IncludeBootstrapCss/IncludeBootstrapをスキップし、ウィジェットにあなたのものを継承させてください — これだけでビューアはアプリにネイティブな外観になります。 - 使用するバンドルだけを含めてください。 すべての
CssConfig/ScriptConfigフラグはオプトインです;バンドルが少なければ少ないほど、対処すべきスタイルも減ります。
レベル 3 — 独自のツールバーを作成
完全にブランド化された体験を実現するには、独自の UI からウィジェットを操作します。そのようなツールバーはホストのマークアップとアプリ固有のヘルパーで構成され、埋め込み SDK リボンではありません。初期化時に返される docViewer インスタンスは API の入り口であり、独自のエンドポイントと共に使用します — ここでは ビューアの仕組み の ViewerApi/Open アクションです:
<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('/ViewerApi/Open?fileName=Sample.pdf', { method: 'POST' });
const token = await resp.text();
objViewer.View(token);
});
</script>検索と注釈は異なります:それらのオプションのリボンコンポーネントは SDK(IncludeSearchBar、IncludeAnnotationBar)に埋め込まれ、独自の DOM を生成します。これらをカスタム Viewer ツールバーと共に使用することも、スキップして基礎となるウィジェット API を直接呼び出すこともできます。完全な統合手順については クイックスタート を参照してください。
ダークモードと RTL
ウィジェットにはダークテーマが同梱されていません;背景やボーダーに対してダークモード用クラス(例:.dark #divDocViewer { … })を対象としたレベル 2 の上書きでほとんどの要件を満たせます。ページコンテンツ自体は画像として描画されるためです。RTL ホストの場合、ビューアは RTL レイアウト内で問題なく動作します — 独自のツールバーも RTL に対応させてください。
やってはいけないこと
埋め込みスタイルシートをフォークしたり編集したりしないでください:それらはパッケージ内に同梱され、すべての更新で置き換えられます。独自のスタイルシートでの上書きはアップグレードを乗り越えますが、viewer.css の編集は残りません。
このページは役に立ちましたか?