Benutzerdefinierte Themen
Gestalten Sie den Viewer passend zu Ihrer App
Der Viewer wird mit einem neutralen, auf Bootstrap basierenden Look ausgeliefert, der aus den eingebetteten Ressourcen (viewer.css) stammt, plus feature‑spezifische Stylesheets wie searchBar.css und annotationBar.css. Das Theming erfolgt auf drei Ebenen – wählen Sie die flachste, die Sie ans Ziel bringt.
Level 1 — Chrome konfigurieren
Viel „theming“ ist eigentlich nur Konfiguration:
ViewerConfig.ShowThumbs = false— kein Miniaturbild‑Panel.ViewerConfig.FitType = "height" | "width"— wie Seiten den Viewport füllen.- Selektive
CssConfig/ScriptConfig‑Bundles — behalten Sie nur das Chrome, das Ihr Host verwendet.
Level 2 — CSS überschreiben
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:
/* Ihr Stylesheet, geladen nach ReferenceCss() */
/* Die beiden Container, die Sie besitzen */
#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 sich innerhalb jedes beliebigen Containers, den Sie #divDocViewer / #div_ctlDoc geben (das Standard‑Container‑Paar aus dem Schnellstart).
Zwei praktische Regeln:
- Laden Sie Bootstrap nicht doppelt. Wenn Ihre App bereits Bootstrap bereitstellt, überspringen Sie
IncludeBootstrapCss/IncludeBootstrapund lassen Sie das Widget Ihres übernehmen — das allein lässt den Viewer nativ in Ihrer App aussehen. - Binden Sie nur die Bundles ein, die Sie verwenden. Jede
CssConfig/ScriptConfig‑Flagge ist optional; weniger Bundles, weniger Styles zum Bekämpfen.
Level 3 — Eigene Symbolleiste erstellen
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 — hier die ViewerApi/Open‑Aktion aus Wie der Viewer funktioniert:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- Ihr Designsystem, Ihre Symbole -->
</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: () => { /* Aktivieren Sie Ihre Schaltflächen */ },
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>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 den Schnellstart für die vollständige Integrationsreihenfolge.
Dunkelmodus und RTL
Das Widget liefert kein dunkles Thema; ein Level‑2‑Override, das Ihre Dark‑Mode‑Klasse (z. B. .dark #divDocViewer { … }) für Hintergründe und Rahmen anspricht, deckt die meisten Bedürfnisse 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‑aware ist.
Was man nicht tun sollte
Forken 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?