ViewerConfig

ViewerConfig (namnrymd Doconut) beskriver webbläsarvisarens 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ärleder inte längre globala funktionsnamn från behållar‑id — och ResPath måste peka på resursprefixet snarare än applikationsroten. Båda lämnar servern att fungera perfekt och rapporterar inget i webbläsarkonsolen. Om du bär med dig en sida från det tidigare biblioteket, läs Återuppringningar och Sökvägskontrollista 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ökvägs‑/passnings‑nycklar ä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-implementationen.

Ange alla beteendemässigt viktiga värden istället för att förlita sig 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 i init‑objektet. Den tidigare visaren letade upp globala funktioner vars namn den hämtade från container‑id‑t – en sida med <div id="div_ctlDoc"> behövde bara deklarera function ctlDoc_OnViewerReady(). Den sökningen är borta. Skicka funktionen explicit:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... dina befintliga alternativ ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // hittades via namn
    onViewerReady:    ctlDoc_OnViewerReady,     // hittades via 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 – hantering av hyperlänkar är inbyggd och styrs av showHyperlinks.

Publika metodgrupper

JavaScript‑filen innehåller även interna hjälpfunktioner. Behandla endast de metoder som används av referens‑UI‑t 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 avsett för asynkron sidproduktion och försöker igen på det aktuella 202 Accepted‑beredskaps‑svaret samt det äldre 409 Conflict‑signalet. När det är aktiverat pollar widgeten med dessa JavaScript‑standardvärden:

Lämna det inaktiverat för den normala en‑nod‑visaren. Att aktivera det kan inte göra en osupporterad synkron rendering asynkron.

Aktivera det när sidor levereras från delat lagringsutrymme med FirstPagePriority, där senare sidor legitimerat svarar 202 Accepted tills de är skrivna. En klient som inte försöker igen visar trasiga kakel för sidor som fortfarande renderas — se Distribuerade distributioner.

Kontrollista för sökväg

• DoconutOptions.MiddlewarePath måste beskriva den gren du faktiskt mappar.
• BasePath måste rikta in sig på den grenen, skrivet utan inledande / ('doconut', inte '/doconut': visningsprogrammet 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 pekar normalt på dess images‑undermapp, utan inledande / — 'doconut-res/images' med standardprefixet. En tom ResPath var korrekt i det tidigare biblioteket, där resurser kom från applikationsroten; det är inte korrekt här, och det misslyckas utan ett felmeddelande.
• ExtractHyperlinks måste vara aktiverat i serverns formatkonfiguration innan showHyperlinks kan visa någonting.