ViewerConfig

ViewerConfig (namespace Doconut) περιγράφει την εμφάνιση και τη συμπεριφορά του προβολέα του προγράμματος περιήγησης. Δεν επηρεάζει την ποιότητα απόδοσης του εγγράφου· χρησιμοποιήστε μια διαμόρφωση μορφής γι' αυτό. Η κλάση C# και το παλαιό πρόσθετο JavaScript έχουν διαφορετικές προεπιλογές, επομένως αντιστοιχίστε τις τιμές ρητά.

Ιδιότητες C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "/",                 // "/" = ο χειριστής DocImage.axd στη ρίζα του ιστότοπου (Web.config)
    ResPath = "doconut-res/images", // ο φάκελος images κάτω από το ResourcesPath, χωρίς αρχικό '/'
    ShowHyperlinks = true
};
// Εκδόστε το με viewer.RenderViewer("viewerEl", token, config) - δείτε την αναφορά Viewer.

Δημιουργία ViewerConfig με RenderViewer

Viewer.RenderViewer(elementId, token, config) μετατρέπει ένα ViewerConfig σε script αρχικοποίησης του widget. Γράφει έξι από τις παραπάνω ιδιότητες — BasePath, ResPath, ShowThumbs, AutoLoad, PageZoom και FitType — και στη συνέχεια καλεί το View(token). Οι άλλες ιδιότητες δεν γράφονται: για MaxZoom, ShowHyperlinks, τις ρυθμίσεις ζουμ ή οποιοδήποτε callback, αρχικοποιήστε το widget μόνοι σας με τις παρακάτω επιλογές JavaScript. Δείτε το Viewer για RenderViewer.

Αντιστοίχιση C# σε JavaScript

Μην περάσετε ένα άμεσα σειριακό ViewerConfig στο docViewer(...). Τα περισσότερα κλειδιά του widget είναι camelCase, ενώ τρία καθιερωμένα κλειδιά path/fit είναι PascalCase.

Προεπιλογές JavaScript

Το widget έχει παλαιότερες προεπιλογές που διαφέρουν από την κλάση C#. Οι παρακάτω τιμές προέρχονται από την τρέχουσα υλοποίηση docViewer.js.

Ορίστε όλες τις τιμές που είναι σημαντικές για τη συμπεριφορά αντί να βασίζεστε σε κάποιο από τα σύνολα προεπιλογών:

<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: '/',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Κλήσεις επιστροφής

Κρατήστε τις κλήσεις επιστροφής γρήγορες· στείλτε τηλεμετρία ασύγχρονα και μην μπλοκάρετε την απόδοση της σελίδας.

Δημόσιες ομάδες μεθόδων

Το αρχείο JavaScript περιέχει επίσης εσωτερικές βοηθητικές λειτουργίες. Θεωρήστε μόνο τις μεθόδους που χρησιμοποιούνται από το αναφορά UI και τεκμηριώνονται εδώ ή στους οδηγούς χαρακτηριστικών ως σταθερά σημεία ενσωμάτωσης.

Επιλογές επανάληψης

Το widget επίσης δέχεται retryOn409 και τις ρυθμίσεις επαναπροσέγγισής του (retryInitialDelayMs, retryBackoffFactor, retryMaxDelayMs, retryMaxAttempts, retryMaxTotalMs). Σερβίρουν εγκαταστάσεις των οποίων οι σελίδες παράγονται στο παρασκήνιο. DocImage.axd αποδίδει κάθε σελίδα κατά τη διάρκεια του αιτήματος, οπότε αφήστε το retryOn409 απενεργοποιημένο.

Λίστα ελέγχου διαδρομής

• BasePath είναι '/' όταν ο χειριστής DocImage.axd βρίσκεται στη ρίζα του site — το χαρακτηριστικό path του χειριστή στο Web.config καθορίζει πού απαντά. Σε εικονικό φάκελο, χρησιμοποιήστε το όνομα του φακέλου χωρίς αρχικό / ('myapp', όχι '/myapp': ο προβολέας προσθέτει την κάθετο, και //myapp/... είναι αίτημα σε άλλο κεντρικό υπολογιστή).
• DoconutOptions.ResourcesPath είναι όπου το module πόρων εξυπηρετεί τα ενσωματωμένα αρχεία (/doconut-res από προεπιλογή).
• ResPath στοχεύει το υποφάκελο images του, επίσης χωρίς αρχικό / ('doconut-res/images'). Η κατεύθυνση του προς 'doconut-res' κάνει κάθε εικονίδιο 404 ενώ το έγγραφο εξακολουθεί να αποδίδεται.
• Στο MVC, το routes.IgnoreRoute("doconut-res/{*pathInfo}") πρέπει να ακολουθεί το ResourcesPath αν το αλλάξετε.
• Το ExtractHyperlinks πρέπει να είναι ενεργοποιημένο στη διαμόρφωση μορφής του διακομιστή πριν το showHyperlinks μπορεί να εμφανίσει οτιδήποτε.