Niestandardowe Motywy
Stylizuj przeglądarkę, aby pasowała do Twojej aplikacji
Przeglądarka jest dostarczana z neutralnym, opartym na Bootstrap wyglądem, pochodzącym z wbudowanych zasobów (viewer.css, oraz arkuszy stylów per‑funkcja takich jak searchBar.css i annotationBar.css). Motywy są stosowane na trzech poziomach — wybierz najpłytszy, który spełni Twoje potrzeby.
Poziom 1 — Konfiguracja obramowania
ViewerConfig.ShowThumbs = false— brak panelu miniatur.ViewerConfig.FitType = "height" | "width"— sposób wypełniania stron widocznego obszaru.- Selektywne pakiety
CssConfig/ScriptConfig— zachowaj tylko obramowanie, którego używa Twój host.
Poziom 2 — Nadpisywanie CSS
Viewer.ReferenceCss() generuje zwykłe znaczniki <link>; wszystko, co załadujesz po nich, wygrywa w kaskadzie. Określ rozmiar i ramkę przeglądarki w swoim własnym arkuszu stylów:
/* Twój arkusz stylów, załadowany po ReferenceCss() */
/* Dwa kontenery, które posiadasz */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Karty strony widgetu */
.docPage { max-width: none; }Strona hosta kontroluje całkowicie zewnętrzny układ — widżet renderuje się wewnątrz dowolnego kontenera, który podasz #divDocViewer / #div_ctlDoc (standardowa para kontenerów z Szybkiego startu).
Dwie praktyczne zasady:
- Nie ładuj podwójnie Bootstrap. Jeśli Twoja aplikacja już dostarcza Bootstrap, pomiń
IncludeBootstrapCss/IncludeBootstrapi pozwól widżetowi dziedziczyć Twój — to samo w sobie sprawia, że przeglądarka wygląda natywnie w Twojej aplikacji. - Dołącz tylko pakiety, których używasz. Każda flaga
CssConfig/ScriptConfigjest opcjonalna; mniej pakietów, mniej stylów do zwalczania.
Poziom 3 — Zbuduj własny pasek narzędzi
Aby uzyskać w pełni markową obsługę, steruj widżetem z własnego interfejsu użytkownika. Taki pasek narzędzi to znacznik hosta plus pomocnik specyficzny dla aplikacji; nie jest to wbudowany wstążka SDK. Instancja docViewer zwrócona po inicjalizacji jest Twoją powierzchnią API, wraz z własnymi punktami końcowymi — tutaj akcja ViewerApi/Open z Jak działa przeglądarka:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- twój system projektowy, twoje ikony -->
</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: () => { /* włącz swoje przyciski */ },
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>Wyszukiwanie i adnotacje są różne: ich opcjonalne komponenty wstążki są osadzone w SDK (IncludeSearchBar, IncludeAnnotationBar) i generują własny DOM. Możesz używać ich razem z własnym paskiem narzędzi przeglądarki lub pominąć je i samodzielnie wywoływać podstawowe API widżetu. Zobacz Szybki start, aby poznać pełną kolejność integracji.
Tryb ciemny i RTL
Widżet nie dostarcza motywu ciemnego; nadpisanie na poziomie 2, które celuje w Twoją klasę trybu ciemnego (np. .dark #divDocViewer { … }) na tle i obramowaniach, pokrywa większość potrzeb, ponieważ samą treść strony renderuje się jako obrazy. Dla hostów RTL, przeglądarka działa bez problemu w układzie RTL — upewnij się, że Twój własny pasek narzędzi jest świadomy RTL.
Czego nie robić
Nie forkować ani nie edytować wbudowanych arkuszy stylów: są one dostarczane w pakiecie i zastępowane przy każdej aktualizacji. Nadpisania w Twoim własnym arkuszu stylów przetrwają aktualizacje; zmiany w viewer.css nie.
Czy ta strona była pomocna?