Benutzerdefinierte Themen
Gestalten Sie den Viewer passend zu Ihrer App
Der Viewer wird mit einem neutralen, auf Bootstrap basierenden Aussehen ausgeliefert, das aus den eingebetteten Ressourcen (viewer.css) sowie feature-spezifischen Stylesheets wie searchBar.css und annotationBar.css bereitgestellt wird. Das Theming erfolgt auf drei Ebenen – wählen Sie die flachste Ebene, die Ihr Ziel erreicht.
Ebene 1 — Konfigurieren Sie die Oberfläche
ViewerConfig.ShowThumbs = false— kein Miniaturbild-Panel.ViewerConfig.FitType = "height" | "width"— wie Seiten den Ansichtsbereich füllen.- Selektive
CssConfig/ScriptConfig-Bündel — behalten Sie nur die Oberfläche, die Ihr Host verwendet.
Ebene 2 — Überschreiben Sie das CSS
Viewer.ReferenceCss() erzeugt einfache <link>-Tags; alles, was Sie nach ihnen laden, gewinnt die Kaskade. Größe und Rahmen des Viewers aus Ihrem eigenen Stylesheet festlegen:
/* Dein Stylesheet, geladen nach ReferenceCss() */
/* Die beiden Container, die du besitzt */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Widget‑Seitenkarten */
.docPage { max-width: none; }Die Host-Seite steuert das äußere Layout vollständig — das Widget rendert innerhalb des beliebigen Containers, den Sie #divDocViewer / #div_ctlDoc übergeben (das Standard-Container-Paar aus dem Quick Start).
Zwei praktische Regeln:
- Laden Sie Bootstrap nicht doppelt. Wenn Ihre App bereits Bootstrap mitliefert, überspringen Sie
IncludeBootstrapCss/IncludeBootstrapund lassen Sie das Widget Ihr Bootstrap erben — das allein lässt den Viewer nativer in Ihrer App wirken. - Binden Sie nur die Bündel ein, die Sie verwenden. Jede
CssConfig/ScriptConfig-Kennzeichnung ist optional; weniger Bündel bedeuten weniger zu bekämpfende Styles.
Ebene 3 — Erstellen Sie Ihre eigene Symbolleiste
Für ein vollständig gebrandetes Erlebnis steuern Sie das Widget über Ihre eigene UI. Eine solche Symbolleiste besteht aus Host-Markup plus einem app-spezifischen Helfer; sie ist kein eingebettetes SDK-Ribbon. Die von der Initialisierung zurückgegebene docViewer-Instanz ist Ihre API-Oberfläche, zusammen mit Ihren eigenen Endpunkten:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- Dein Designsystem, deine Icons -->
</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: () => { /* Aktiviere deine Buttons */ },
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>Suche und Annotation unterscheiden sich: ihre optionalen Ribbon-Komponenten sind im SDK (IncludeSearchBar, IncludeAnnotationBar) eingebettet und erzeugen ihr eigenes DOM. Sie können sie zusammen mit Ihrer benutzerdefinierten Viewer‑Symbolleiste verwenden oder sie überspringen und die zugrunde liegenden Widget‑APIs selbst aufrufen. Siehe das komplette Viewer‑Paket im Quick Start für die vollständige Integrationsreihenfolge.
Dunkelmodus und RTL
Das Widget liefert kein dunkles Thema; ein Override auf Ebene 2, das Ihre Dark‑Mode‑Klasse (z. B. .dark #divDocViewer { … }) für Hintergründe und Rahmen anspricht, deckt die meisten Anforderungen ab, da der Seiteninhalt selbst als Bild gerendert wird. Für RTL‑Hosts funktioniert der Viewer problemlos innerhalb eines RTL‑Layouts — achten Sie darauf, dass Ihre eigene Symbolleiste RTL‑bewusst ist.
Was Sie nicht tun sollten
Verzweigen oder bearbeiten Sie die eingebetteten Stylesheets nicht: Sie werden im Paket ausgeliefert und bei jedem Update ersetzt. Overrides in Ihrem eigenen Stylesheet überstehen Upgrades; Änderungen an viewer.css nicht.
War diese Seite hilfreich?