Anpassade teman
Styla visaren så att den matchar din app
Visaren levereras med ett neutralt, Bootstrap-baserat utseende som serveras från de inbäddade resurserna (viewer.css, samt per-funktions stilmallar som searchBar.css och annotationBar.css). Tematisering sker på tre nivåer — välj den grundläggande som räcker för ditt behov.
Nivå 1 — Konfigurera ramen
Mycket av ”tematiseringen” är egentligen konfiguration:
ViewerConfig.ShowThumbs = false— ingen miniatyrpanel.ViewerConfig.FitType = "height" | "width"— hur sidor fyller visningsområdet.- Selektiva
CssConfig/ScriptConfig-paket — behåll bara den ram din värd använder.
Nivå 2 — Överskriv CSS
Viewer.ReferenceCss() avger enkla <link>-taggar; allt du laddar efter dem vinner i kaskaden. Storlek och ram för visaren från din egen stilmall:
/* Din stilmall, laddad efter ReferenceCss() */
/* De två containrarna du äger */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Widget-sidkort */
.docPage { max-width: none; }Värdsidan styr den yttre layouten helt — widgeten renderas inuti vilken ruta du än ger #divDocViewer / #div_ctlDoc (det standardbehållarpar som finns i Snabbstart).
Två praktiska regler:
- Ladda inte Bootstrap två gånger. Om din app redan levererar Bootstrap, hoppa över
IncludeBootstrapCss/IncludeBootstrapoch låt widgeten ärva din — detta ensam får visaren att se inbyggd i din app ut. - Inkludera bara de paket du använder. Varje
CssConfig/ScriptConfig-flagga är valfri; färre paket, färre stilar att kämpa mot.
Nivå 3 — Bygg ditt eget verktygsfält
För en helt varumärkesanpassad upplevelse, styr widgeten från ditt eget UI. Sådant verktygsfält är värdmärkning plus en app-specifik hjälpreda; det är inte ett inbäddat SDK-band. docViewer-instansen som returneras vid initiering är ditt API-ytlager, tillsammans med dina egna slutpunkter:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- ditt designsystem, dina ikoner -->
</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: () => { /* aktivera dina knappar */ },
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>Sök och Anmärkning är olika: deras valfria Ribbon-komponenter är inbäddade i SDK:n (IncludeSearchBar, IncludeAnnotationBar) och genererar sin egen DOM. Du kan använda dem tillsammans med ditt anpassade Viewer-verktygsfält eller hoppa över dem och anropa widgetens underliggande API:er själv. Se den fullständiga Viewer-paketet i Snabbstart för den kompletta integrationsordningen.
Mörkt läge och RTL
Widgeten levereras inte med ett mörkt tema; en nivå‑2‑överskrivning som riktar sig mot din mörkt‑läge‑klass (t.ex. .dark #divDocViewer { … }) på bakgrunder och kanter täcker de flesta behov, eftersom sidans innehåll själv renderas som bild. För RTL‑värdar fungerar visaren bra inuti en RTL‑layout — håll ditt eget verktygsfält RTL‑medvetet.
Vad du inte bör göra
Forka eller redigera inte de inbäddade stilmallarna: de levereras i paketet och ersätts vid varje uppdatering. Överskrivningar i din egen stilmall överlever uppgraderingar; redigeringar av viewer.css gör de inte.
Var den här sidan hjälpsam?