ViewerConfig

ViewerConfig (namespace Doconut) beskriver webbläsarens visares utseende och beteende. Det påverkar inte dokumentrenderingskvaliteten; använd en formatkonfiguration för det. C#-klassen och den långvariga JavaScript-widgeten har olika standardvärden, så mappa värden explicit.

Två klient‑sidiga förändringar i denna version misslyckas tyst. Handlare‑funktioner skickas som alternativ — widgeten hämtar inte längre globala funktionsnamn från behållar‑id — och ResPath måste peka på resursprefixet snarare än applikationsroten. Båda låter servern fungera perfekt och rapporterar inget i webbläsarkonsolen. Om du bär med dig en sida från det föregående biblioteket, läs Callbacks och Path checklist innan något annat.

C#‑egenskaper

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // ingen inledande '/' : visaren lägger till den ("/doconut" skulle bli //doconut, en annan värd)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

C# till JavaScript‑mappning

Skicka inte en direkt serialiserad ViewerConfig till docViewer(...). De flesta widget‑nycklar är camelCase, medan tre etablerade sök‑/anpassningsnycklar är PascalCase.

JavaScript-standardvärden

Widgeten har äldre standardvärden som skiljer sig från C#-klassen. Följande värden kommer från den aktuella docViewer.js-implementeringen.

Ställ in alla beteendemässigt viktiga värden istället för att förlita dig på någon av standarduppsättningarna:

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

Återuppringningar

Håll återuppringningarna snabba; skicka telemetri asynkront och blockera inte sidrenderingen.

Var och en av dessa är ett alternativ på init‑objektet. Den tidigare visaren letade upp globala funktioner vars namn den härledde från behållar‑id‑t – en sida med <div id="div_ctlDoc"> behövde bara deklarera function ctlDoc_OnViewerReady(). Den uppslagningen är borta. Skicka funktionen explicit:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... dina befintliga alternativ ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // hittades med namn
    onViewerReady:    ctlDoc_OnViewerReady,     // hittades med namn
    onCopy:           ctlDoc_Copy,              // var ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // var ctlDoc_AutoLoadStatus(page)
});

Den gamla uppslagningen var inbäddad i en tom catch, så inget någonsin rapporterades. I den här releasen körs funktionerna helt enkelt aldrig: det vanliga symptomet är en upptagen spinner som aldrig slutar, eftersom hanteraren som gömde den var onViewerReady. Dokumentet bakom den renderas korrekt.

Det finns ingen återuppringning för länkklick – hyperlänkhantering är inbyggd och styrs av showHyperlinks.

Publika metodgrupper

JavaScript-filen innehåller också interna hjälpfunktioner. Behandla endast metoder som används av referens‑UI och som dokumenteras här eller i funktionsguiderna som stabila integrationspunkter.

Försök igen medan en distribuerad sida fortfarande renderas

retryOn409 behåller sitt historiska namn. Det är för asynkron sidproduktion och återförsöker den aktuella 202 Accepted-beredskapsresponsen samt den äldre 409 Conflict-signalen. När det är aktiverat pollar widgeten med dessa JavaScript‑standardvärden:

Lämna den inaktiverad för den normala enkelnodsvyn. Att aktivera den kan inte göra en ej stödd synkron rendering asynkron.

Aktivera den när sidor levereras från delat lagringsutrymme med FirstPagePriority, där senare sidor legitimit svarar med 202 Accepted tills de skrivs. En klient som inte återförsöker visar trasiga rutor för sidor som fortfarande renderas — se Distributed Deployments.

Sökvägskontrollista

• DoconutOptions.MiddlewarePath måste beskriva den gren du faktiskt mappar.
• BasePath måste rikta in sig på den grenen, skriven utan ett inledande / ('doconut', inte '/doconut': vyn lägger till snedstrecket, och //doconut/... är en begäran till en annan värd). Referensapplikationen behåller den historiska DocImage.axd-begäransformen på en MapWhen-gren och sätter därför BasePath: '/'.
• DoconutOptions.ResourcesPath är den inbäddade resursrutten.
• ResPath riktar normalt mot sin images-undermapp, utan ett inledande / — 'doconut-res/images' med standardprefixet. En tom ResPath var korrekt i det tidigare biblioteket, där resurser kom från applikationsroten; den är inte korrekt här, och den misslyckas utan ett fel.
• ExtractHyperlinks måste vara aktiverad i serverns formatkonfiguration innan showHyperlinks kan visa något.