ViewerConfig

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

Δύο αλλαγές στην πλευρά του πελάτη σε αυτή την έκδοση αποτυγχάνουν σιωπηρά. Οι συναρτήσεις χειριστή περνιούνται ως επιλογές — το widget δεν εξάγει πλέον ονόματα παγκόσμιων συναρτήσεων από το id του container — και το ResPath πρέπει να δείχνει στο πρόθεμα των πόρων αντί στη ρίζα της εφαρμογής. Και τα δύο αφήνουν τον διακομιστή να λειτουργεί τέλεια και δεν αναφέρουν τίποτα στην κονσόλα του προγράμματος περιήγησης. Αν προωθείτε μια σελίδα από την προηγούμενη βιβλιοθήκη, διαβάστε Κλήσεις επιστροφής και Λίστα ελέγχου διαδρομής πριν οτιδήποτε άλλο.

Ιδιότητες C#

var config = new ViewerConfig
{
    ShowThumbs = true,
    AutoLoad = false,
    PageZoom = 100,
    MaxZoom = 300,
    FitType = "width",
    BasePath = "doconut",           // χωρίς αρχικό '/': ο προβολέας το προσθέτει ("/doconut" θα γίνει //doconut, άλλο host)
    ResPath = "doconut-res/images",
    ShowHyperlinks = true
};

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

Μην περάσετε ένα άμεσα σειριοποιημένο ViewerConfig στο docViewer(...). Οι περισσότερες κλειδιά του widget είναι camelCase, ενώ τρία καθιερωμένα κλειδιά διαδρομής/προσαρμογής είναι 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: 'doconut',
    ResPath: 'doconut-res/images',
    onViewerReady: function () {},
    onError: function (message) { console.error('DocViewer:', message); }
});
</script>

Ανακλήσεις

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

Κάθε μία από αυτές είναι μια επιλογή στο αντικείμενο init. Ο προηγούμενος προβολέας έψαχνε παγκόσμιες συναρτήσεις των οποίων τα ονόματα προερχόταν από το id του container — μια σελίδα με <div id="div_ctlDoc"> έπρεπε μόνο να δηλώσει function ctlDoc_OnViewerReady(). Αυτή η αναζήτηση έχει αφαιρεθεί. Περνάτε τη συνάρτηση ρητά:

objctlDoc = $('#div_ctlDoc').docViewer({
    // ... οι υπάρχουσες επιλογές σας ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // βρέθηκε με το όνομα
    onViewerReady:    ctlDoc_OnViewerReady,     // βρέθηκε με το όνομα
    onCopy:           ctlDoc_Copy,              // ήταν ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // ήταν ctlDoc_AutoLoadStatus(page)
});

Η παλιά αναζήτηση τυλίχτηκε σε ένα κενό catch, έτσι δεν αναφέρθηκε τίποτα. Σε αυτήν την έκδοση οι συναρτήσεις απλώς δεν εκτελούνται: το συνηθισμένο σύμπτωμα είναι ένας δείκτης φόρτωσης που δεν σταματά ποτέ, επειδή ο χειριστής που το κρύβει ήταν το onViewerReady. Το έγγραφο πίσω από αυτό αποδίδεται σωστά.

Δεν υπάρχει ανακλήση κλικ σε σύνδεσμο — η διαχείριση υπερσυνδέσμων είναι ενσωματωμένη και ελέγχεται από το showHyperlinks.

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

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

Επανάληψη ενώ μια κατανεμημένη σελίδα εξακολουθεί να αποδίδεται

retryOn409 διατηρεί το ιστορικό του όνομα. Χρησιμοποιείται για ασύγχρονη παραγωγή σελίδων και επαναλαμβάνει την τρέχουσα απόκριση ετοιμότητας 202 Accepted καθώς και το παλαιότερο σήμα 409 Conflict. Όταν είναι ενεργοποιημένο, το widget ελέγχει με αυτές τις προεπιλογές JavaScript:

Αφήστε το απενεργοποιημένο για τον κανονικό προβολέα μονού κόμβου. Η ενεργοποίησή του δεν μπορεί να κάνει μια μη υποστηριζόμενη συγχρονική απόδοση ασύγχρονη.

Ενεργοποιήστε το όταν οι σελίδες εξυπηρετούνται από κοινόχρηστη αποθήκευση με FirstPagePriority, όπου οι μεταγενέστερες σελίδες απαντούν νόμιμα 202 Accepted μέχρι να γραφτούν. Ένας πελάτης που δεν επαναλαμβάνει εμφανίζει σπασμένα πλακίδια για σελίδες που εξακολουθούν να αποδίδονται — δείτε Κατανεμημένες Αναπτύξεις.

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

• DoconutOptions.MiddlewarePath πρέπει να περιγράφει το κλαδί που πραγματικά αντιστοιχίζετε.
• BasePath πρέπει να στοχεύει σε αυτό το κλαδί, γραμμένο χωρίς αρχικό / ('doconut', όχι '/doconut': ο προβολέας προσθέτει την κάθετο, και //doconut/... είναι αίτηση σε άλλο κεντρικό υπολογιστή). Η αναφορά εφαρμογής διατηρεί το ιστορικό σχήμα αίτησης DocImage.axd σε κλαδί MapWhen και επομένως ορίζει BasePath: '/'.
• DoconutOptions.ResourcesPath είναι η διαδρομή ενσωματωμένων πόρων.
• ResPath συνήθως στοχεύει στον υποφάκελο images του, χωρίς αρχικό / — 'doconut-res/images' με το προεπιλεγμένο πρόθεμα. Ένα κενό ResPath ήταν σωστό στην προηγούμενη βιβλιοθήκη, όπου οι πόροι προέρχονταν από τη ρίζα της εφαρμογής· δεν είναι σωστό εδώ και αποτυγχάνει χωρίς σφάλμα.
• ExtractHyperlinks πρέπει να είναι ενεργοποιημένο στη διαμόρφωση μορφής του διακομιστή πριν το showHyperlinks μπορεί να εμφανίσει κάτι.