ViewerConfig

ViewerConfig (namespace Doconut) beschreibt das Aussehen und Verhalten des Browser‑Viewers. Es beeinflusst nicht die Qualität der Dokumentendarstellung; dafür verwenden Sie eine Format‑Konfiguration. Die C#‑Klasse und das seit langem bestehende JavaScript‑Widget haben unterschiedliche Vorgaben, daher Werte explizit zuordnen.

Zwei clientseitige Änderungen in diesem Release schlagen stillschweigend fehl. Handler‑Funktionen werden als Optionen übergeben — das Widget leitet keine globalen Funktionsnamen mehr aus der Container‑ID ab — und ResPath muss auf das Ressourcen‑Präfix statt auf die Anwendungswurzel zeigen. Beide lassen den Server einwandfrei arbeiten und melden nichts in der Browser‑Konsole. Wenn Sie eine Seite aus der vorherigen Bibliothek übernehmen, lesen Sie zuerst Rückrufe und Pfad‑Checkliste.

C# properties

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/doconut",
    ResPath = "/doconut-res/images",
    ShowHyperlinks = true
};

C# to JavaScript mapping

JavaScript defaults

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

Callbacks

Halten Sie Callbacks kurz; senden Sie Telemetrie asynchron und blockieren Sie das Laden der Seite nicht.

Jede dieser ist eine Option im Initialisierungs‑Objekt. Der vorherige Viewer suchte globale Funktionen, deren Namen er aus der Container‑ID ableitete — eine Seite mit <div id="div_ctlDoc"> musste nur function ctlDoc_OnViewerReady() deklarieren. Diese Suche ist weggefallen. Übergeben Sie die Funktion explizit:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... your existing options ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // was found by name
    onViewerReady:    ctlDoc_OnViewerReady,     // was found by name
    onCopy:           ctlDoc_Copy,              // was ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // was ctlDoc_AutoLoadStatus(page)
});

Die alte Suche war in ein leeres catch eingebettet, sodass nie etwas gemeldet wurde. In diesem Release werden die Funktionen einfach nie ausgeführt: Das typische Symptom ist ein dauernd drehender Lade‑Spinner, weil der Handler, der ihn versteckt hätte, onViewerReady war. Das Dokument dahinter wird korrekt gerendert.

Es gibt keinen Callback für Link‑Klicks — die Hyperlink‑Verarbeitung ist eingebaut und wird von showHyperlinks gesteuert.

Public method groups

Die JavaScript‑Datei enthält ebenfalls interne Hilfsfunktionen. Betrachten Sie nur die Methoden, die von der Referenz‑UI verwendet und hier oder in den Feature‑Leitfäden dokumentiert sind, als stabile Integrationspunkte.

Retry while a distributed page is still rendering

retryOn409 behält seinen historischen Namen. Es dient der asynchronen Seitenerzeugung und wiederholt die aktuelle 202 Accepted‑Bereitschafts‑Antwort sowie das ältere 409 Conflict‑Signal. Wenn aktiviert, pollt das Widget mit diesen JavaScript‑Standardeinstellungen:

Lassen Sie es für den normalen Single‑Node‑Viewer deaktiviert. Das Aktivieren kann eine nicht unterstützte synchrone Darstellung nicht asynchron machen.

Aktivieren Sie es, wenn Seiten aus gemeinsam genutztem Speicher mit FirstPagePriority bereitgestellt werden, wobei spätere Seiten legitimerweise 202 Accepted zurückgeben, bis sie geschrieben sind. Ein Client, der nicht erneut versucht, zeigt fehlerhafte Kacheln für noch rendernde Seiten — siehe Verteilte Bereitstellungen.

Path checklist

• DoconutOptions.MiddlewarePath muss den Zweig beschreiben, den Sie tatsächlich mappen.
• BasePath muss auf diesen Zweig zeigen. Die Referenz‑Anwendung behält die historische DocImage.axd‑Anfrageform auf einem MapWhen‑Zweig bei und setzt daher BasePath: '/'.
• DoconutOptions.ResourcesPath ist die Route zu den eingebetteten Ressourcen.
• ResPath zielt normalerweise auf dessen Unterordner /images — 'doconut-res/images' mit dem Standard‑Präfix. Ein leerer ResPath war in der vorherigen Bibliothek korrekt, wo Ressourcen vom Anwendungs‑Root kamen; hier ist er nicht korrekt und führt ohne Fehlermeldung zum Scheitern.
• ExtractHyperlinks muss in der Server‑Format‑Konfiguration aktiviert sein, bevor showHyperlinks etwas anzeigen kann.