Temi Personalizzati
Stilizza il visualizzatore per adattarlo alla tua app
Il visualizzatore viene fornito con un aspetto neutro basato su Bootstrap, servito dalle risorse incorporate (viewer.css, più i fogli di stile per funzionalità come searchBar.css e annotationBar.css). La tematizzazione avviene su tre livelli — scegli quello più superficiale che ti porta al risultato desiderato.
Livello 1 — Configura la chrome
Molto del "theming" è in realtà configurazione:
ViewerConfig.ShowThumbs = false— nessun pannello miniatura.ViewerConfig.FitType = "height" | "width"— come le pagine riempiono il viewport.- Bundle selettivi
CssConfig/ScriptConfig— mantieni solo la chrome che il tuo host utilizza.
Livello 2 — Sovrascrivi il CSS
Viewer.ReferenceCss() emette semplici tag <link>; tutto ciò che carichi dopo di essi vince la cascata. Dimensiona e incornicia il visualizzatore dal tuo foglio di stile:
/* Il tuo foglio di stile, caricato dopo ReferenceCss() */
/* I due contenitori che possiedi */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Schede della pagina dei widget */
.docPage { max-width: none; }La pagina host controlla completamente il layout esterno — il widget si rende all'interno di qualsiasi contenitore tu fornisca a #divDocViewer / #div_ctlDoc (la coppia di contenitori standard dal Quick Start).
Due regole pratiche:
- Non caricare due volte Bootstrap. Se la tua app include già Bootstrap, salta
IncludeBootstrapCss/IncludeBootstrape lascia che il widget erediti il tuo — questo da solo fa apparire il visualizzatore nativo alla tua app. - Includi solo i bundle che usi. Ogni flag
CssConfig/ScriptConfigè opzionale; meno bundle, meno stili da gestire.
Livello 3 — Costruisci la tua barra degli strumenti
Per un'esperienza completamente brandizzata, controlla il widget dalla tua UI. Una barra degli strumenti di questo tipo è markup host più un helper specifico dell'app; non è un Ribbon SDK incorporato. L'istanza docViewer restituita dall'inizializzazione è la tua superficie API, insieme ai tuoi endpoint:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- Il tuo sistema di design, le tue icone -->
</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: () => { /* Abilita i tuoi pulsanti */ },
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>Search e Annotation sono diversi: i loro componenti Ribbon opzionali sono incorporati nell'SDK (IncludeSearchBar, IncludeAnnotationBar) e generano il proprio DOM. Puoi usarli insieme alla tua barra degli strumenti Viewer personalizzata o saltarli e chiamare direttamente le API del widget sottostante. Vedi il
pacchetto Viewer completo nel Quick Start
per l'ordine completo di integrazione.
Modalità scura e RTL
Il widget non fornisce un tema scuro; una sovrascrittura di Livello 2 che mira alla tua classe dark-mode (ad esempio .dark #divDocViewer { … }) su sfondi e bordi copre la maggior parte delle esigenze, poiché il contenuto della pagina stesso è reso come immagine. Per gli host RTL, il visualizzatore funziona felicemente all'interno di un layout RTL — mantieni la tua barra degli strumenti consapevole di RTL.
Cosa non fare
Non fare fork o modificare i fogli di stile incorporati: vengono forniti all'interno del pacchetto e vengono sostituiti ad ogni aggiornamento. Le sovrascritture nel tuo foglio di stile sopravvivono agli aggiornamenti; le modifiche a viewer.css no.
Questa pagina è stata utile?