Vlastní motivy
Upravte vzhled prohlížeče tak, aby odpovídal vaší aplikaci
Prohlížeč je dodáván s neutrálním vzhledem založeným na Bootstrapu, který je poskytován z vložených zdrojů (viewer.css, plus stylové listy pro jednotlivé funkce jako searchBar.css a annotationBar.css). Tématizace probíhá ve třech úrovních — vyberte nejméně zásadní, která vás dovede k cíli.
Úroveň 1 — Nastavte chrome
Mnoho „themingu“ je ve skutečnosti konfigurace:
ViewerConfig.ShowThumbs = false— žádný panel miniatur.ViewerConfig.FitType = "height" | "width"— jak stránky vyplňují viewport.- Selektivní balíčky
CssConfig/ScriptConfig— zachovejte jen chrome, který vaše hostitel používá.
Úroveň 2 — Přepište CSS
Viewer.ReferenceCss() vytváří jednoduché značky <link>; vše, co načtete po nich, vyhrává v kaskádě. Nastavte velikost a rám prohlížeče pomocí vlastního stylového listu:
/* Váš stylový list, načtený po ReferenceCss() */
/* Dva kontejnery, které vlastníte */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Karty stránky widgetu */
.docPage { max-width: none; }Hostitelská stránka plně řídí vnější rozvržení — widget se vykresluje uvnitř jakéhokoli kontejneru, který poskytnete #divDocViewer / #div_ctlDoc (standardní dvojice kontejnerů z Quick Start).
Dvě praktické zásady:
- Nenačítejte Bootstrap dvakrát. Pokud vaše aplikace již Bootstrap obsahuje, vynechte
IncludeBootstrapCss/IncludeBootstrapa nechte widget zdědit ten váš — to samo o sobě způsobí, že prohlížeč vypadá jako součást vaší aplikace. - Zahrňte jen balíčky, které používáte. Každý příznak
CssConfig/ScriptConfigje volitelný; méně balíčků, méně stylů, se kterými se musíte potýkat.
Úroveň 3 — Vytvořte si vlastní nástrojovou lištu
Pro plně značkový zážitek ovládejte widget z vlastní UI. Taková nástrojová lišta je hostitelský markup plus aplikací specifický pomocník; není to vložený SDK Ribbon. Instance docViewer vrácená inicializací je vaše API rozhraní, spolu s vašimi vlastními koncovými body:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- váš designový systém, vaše ikony -->
</div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
<script>
const objViewer = $('#div_ctlDoc').docViewer({
showThumbs: true,
autoLoad: false,
BasePath: 'doconut',
ResPath: 'doconut-res/images',
onViewerReady: () => { /* povolte své tlačítka */ },
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>Vyhledávání a anotace jsou odlišné: jejich volitelné komponenty Ribbon jsou vloženy do SDK (IncludeSearchBar, IncludeAnnotationBar) a generují vlastní DOM. Můžete je použít společně s vlastní nástrojovou lištou Vieweru nebo je vynechat a volat podkladové API widgetu sami. Viz kompletní balíček Vieweru v Quick Start pro kompletní pořadí integrace.
Dark mode a RTL
Widget nedodává tmavý motiv; přepsání na úrovni 2, které cílí na vaši třídu dark-mode (např. .dark #divDocViewer { … }) na pozadích a okrajích, pokrývá většinu potřeb, protože samotný obsah stránky je vykreslen jako obrázek. Pro RTL hostitele prohlížeč funguje spokojeně uvnitř RTL rozvržení — udržujte svou vlastní nástrojovou lištu RTL‑vědomou.
Co nedělat
Neforkujte ani neupravujte vložené stylové listy: jsou součástí balíčku a při každé aktualizaci jsou nahrazeny. Přepsání ve vašem vlastním stylovém listu přežije aktualizace; úpravy viewer.css ne.
Byla tato stránka užitečná?