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:

css
/* 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/IncludeBootstrap e 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:

html
<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?