Προσαρμοσμένα Θέματα

Στυλ του προβολέα ώστε να ταιριάζει στην εφαρμογή σας

Ο προβολέας παρέχεται με ουδέτερο, βασισμένο στο Bootstrap, στυλ που σερβίρεται από τους ενσωματωμένους πόρους (viewer.css, συν τα φύλλα στυλ ανά λειτουργία όπως searchBar.css και annotationBar.css). Η θεματοποίηση γίνεται σε τρία επίπεδα — επιλέξτε το πιο ρηχό που σας φέρνει εκεί.

Επίπεδο 1 — Διαμόρφωση του chrome

  • ViewerConfig.ShowThumbs = false — χωρίς πίνακα μικρογραφιών.
  • ViewerConfig.FitType = "height" | "width" — πώς οι σελίδες γεμίζουν το παράθυρο προβολής.
  • Επιλεκτικά bundles CssConfig/ScriptConfig — διατηρήστε μόνο το chrome που χρησιμοποιεί ο κεντρικός σας.

Επίπεδο 2 — Παράκαμψη του CSS

Viewer.ReferenceCss() εκδίδει απλές ετικέτες <link>· οτιδήποτε φορτώνετε μετά από αυτές κερδίζει την αλυσίδα. Μεγεθύνετε και πλαισιώστε τον προβολέα από το δικό σας φύλλο στυλ:

css
/* Το φύλλο στυλ σας, φορτώνεται μετά το ReferenceCss() */

/* Τα δύο containers που έχετε */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }

/* Κάρτες σελίδας Widget */
.docPage { max-width: none; }

Η σελίδα-ξενιστής ελέγχει πλήρως τη εξωτερική διάταξη — το widget αποδίδει μέσα σε οποιοδήποτε κουτί δώσετε #divDocViewer / #div_ctlDoc (το τυπικό ζεύγος containers από τη Γρήγορη Εκκίνηση).

  • Μην φορτώνετε δύο φορές το Bootstrap. Αν η εφαρμογή σας ήδη περιλαμβάνει Bootstrap, παραλείψτε IncludeBootstrapCss/IncludeBootstrap και αφήστε το widget να κληρονομήσει το δικό σας — αυτό μόνο κάνει τον προβολέα να φαίνεται εγγενής στην εφαρμογή σας.
  • Συμπεριλάβετε μόνο τα bundles που χρησιμοποιείτε. Κάθε σημαία CssConfig/ScriptConfig είναι προαιρετική· λιγότερα bundles, λιγότερα στυλ να αντιμετωπίσετε.

Επίπεδο 3 — Δημιουργήστε τη δική σας γραμμή εργαλείων

Για μια πλήρως επωνυμοποιημένη εμπειρία, ελέγξτε το widget από το δικό σας UI. Μια τέτοια γραμμή εργαλείων είναι markup του ξενιστή συν έναν βοηθό ειδικό για την εφαρμογή· δεν είναι ενσωματωμένο SDK Ribbon. Η περίπτωση docViewer που επιστρέφεται με την αρχικοποίηση είναι η επιφάνεια API σας, μαζί με τα δικά σας endpoints — εδώ η ενέργεια ViewerApi/Open από το Πώς Λειτουργεί ο Προβολέας:

html
<div id="toolbar">
    <button id="btnOpen">Open</button>
    <button id="btnPrev">‹</button>
    <button id="btnNext">›</button>
    <!-- Το σύστημα σχεδίασής σας, τα εικονίδια σας -->
</div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>

<script>
    const objViewer = $('#div_ctlDoc').docViewer({
        showThumbs: true,
        autoLoad:   false,
        BasePath:   '/',
        ResPath:    'doconut-res/images',
        onViewerReady: () => { /* Ενεργοποιήστε τα κουμπιά σας */ },
        onError: (msg) => console.error('DocViewer:', msg)
    });

    document.getElementById('btnOpen').addEventListener('click', async () => {
        const resp  = await fetch('/ViewerApi/Open?fileName=Sample.pdf', { method: 'POST' });
        const token = await resp.text();
        objViewer.View(token);
    });
</script>

Η Αναζήτηση και η Σχόληση είναι διαφορετικές: τα προαιρετικά στοιχεία Ribbon τους είναι ενσωματωμένα στο SDK (IncludeSearchBar, IncludeAnnotationBar) και δημιουργούν το δικό τους DOM. Μπορείτε να τα χρησιμοποιήσετε μαζί με τη δική σας προσαρμοσμένη γραμμή εργαλείων Viewer ή να τα παραλείψετε και να καλέσετε εσείς τις υποκείμενες APIs του widget. Δείτε το Γρήγορη Εκκίνηση για τη πλήρη σειρά ενσωμάτωσης.

Σκοτεινή λειτουργία και RTL

Το widget δεν παρέχει σκοτεινό θέμα· μια παράκαμψη Επιπέδου 2 που στοχεύει στην κλάση dark-mode σας (π.χ. .dark #divDocViewer { … }) σε φόντα και περιθώρια καλύπτει τις περισσότερες ανάγκες, καθώς το περιεχόμενο της σελίδας αποδίδεται ως εικόνα. Για ξενιστές RTL, ο προβολέας λειτουργεί άψογα μέσα σε διάταξη RTL — διατηρήστε τη δική σας γραμμή εργαλείων ενήμερη για RTL.

Τι δεν πρέπει να κάνετε

Μην κάνετε fork ή επεξεργασία των ενσωματωμένων φύλλων στυλ: παρέχονται μέσα στο πακέτο και αντικαθίστανται σε κάθε ενημέρωση. Οι παρακάμψεις στο δικό σας φύλλο στυλ επιβιώνουν τις αναβαθμίσεις· οι επεξεργασίες στο viewer.css όχι.

Ήταν αυτή η σελίδα χρήσιμη;