ViewerConfig

ViewerConfig (namespace Doconut) descrive l'aspetto e il comportamento del visualizzatore del browser. Non influisce sulla qualità del rendering del documento; usa una configurazione di formato per quello. La classe C# e il plugin JavaScript legacy hanno impostazioni predefinite diverse, quindi mappa i valori esplicitamente.

Proprietà C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // senza '/' iniziale: il visualizzatore lo aggiunge ("/doconut" diventerebbe //doconut, un altro host)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

Mappatura da C# a JavaScript

Non passare un ViewerConfig serializzato direttamente a docViewer(...). La maggior parte delle chiavi del widget è in camelCase, mentre tre chiavi di percorso/fit stabilite sono in PascalCase.

Valori predefiniti JavaScript

Il widget ha impostazioni predefinite più vecchie che differiscono dalla classe C#. I seguenti valori provengono dall'implementazione corrente di docViewer.js.

Imposta tutti i valori comportamentali importanti invece di fare affidamento su uno dei due set di valori predefiniti:

<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
const objViewer = $('#div_ctlDoc').docViewer({
    showThumbs: true,
    autoLoad: false,
    autoFocus: true,
    autoPageFocus: true,
    pageZoom: 100,
    zoomStep: 10,
    maxZoom: 300,
    FitType: 'width',
    cacheEnabled: false,
    largeDoc: false,
    showHyperlinks: true,
    fixedZoom: true,
    fixedZoomPercent: 100,
    fixedZoomPercentMobile: 75,
    BasePath: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Callback

Mantieni i callback veloci; invia i dati di telemetria in modo asincrono e non bloccare il rendering della pagina.

Gruppi di metodi pubblici

Il file JavaScript contiene anche helper interni. Considera stabili solo i metodi usati dall'interfaccia di riferimento e documentati qui o nelle guide delle funzionalità.

Ritenta dopo HTTP 409

retryOn409 è per la produzione di pagine asincrona. Quando abilitato, il widget effettua polling con questi valori predefiniti JavaScript:

Lascialo disabilitato per il visualizzatore normale. Abilitarlo non può trasformare un rendering sincrono non supportato in asincrono.

Checklist del percorso

• DoconutOptions.MiddlewarePath deve descrivere il ramo che effettivamente mappi.
• BasePath deve puntare a quel ramo, scritto senza una barra iniziale / ('doconut', non '/doconut': il visualizzatore aggiunge la barra, e //doconut/... è una richiesta a un altro host).
• DoconutOptions.ResourcesPath è il percorso delle risorse incorporate.
• ResPath normalmente punta alla sua sottocartella images, anch'essa senza una barra iniziale / ('doconut-res/images').
• ExtractHyperlinks deve essere abilitato nella configurazione del formato del server prima che showHyperlinks possa visualizzare qualcosa.